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BACKGROUND OF THE INVENTION 
Field of the Invention 

The present invention is directed to an application program interface (API) 
for an access system. 

Description of the Related Art 

As the impact of the Internet continues to alter the economic landscape, 
companies are experiencing a fundamental shift in how they do business. Business 
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processes involve complex interactions between companies and their customers, 
suppliers, partners, and employees. For example, businesses interact constantly 
with their customers — often other businesses — to provide information on product 
specification and availability. Businesses also interact with vendors and suppliers 
in placing orders and obtaining payments. Businesses must also make a wide array 
of information and services available to their employee populations, generating 
further interactions. To meet new challenges and leverage opportunities, while 
reducing their overall cost-of-interactions, many organizations are migrating to 
network-based business processes and models. Among the most important of these 
is Internet-based E-business. 

To effectively migrate their complex interactions to an Internet-based 
E-business environment, organizations must contend with a wide array of 
challenges and issues. For example, businesses need to securely provide access to 
business applications and content to users they deem authorized. This implies that 
businesses need to be confident that unauthorized use is prevented. Often, this 
involves the nontrivial, ongoing task of attempting to tie together disparate, 
system-specific authentication and/or authorization schemes under one access 
system. 

To meet these challenges, an E-business host company needs an access 
system that delivers the ability to effectively secure and manage all the various 
network-based interactions. An appropriate access system should be able to 
provide authentication and authorization services while accommodating all 
participants involved with the E-business, whether they are local or remote. It 
must also be able to distinguish between the E-business* employees and all the 
users who are affiliated with the E-business host's customers, suppliers and/or 
partners. 

Prior to authorizing a user to access a resource, access systems typically 
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will authenticate a user. That is, they will verify the identity of the user. After a 
user successfully authenticates for a first protected resource, the user may request 
access to a second resource. If the second resource is also protected, the user may 
be required to perform a second authentication for the second resource. However, 
5 it may be redundant to force the user to re-authenticate for the second resource, 
especially if the previous authentication occurred relatively recently. Requiring 
repetitive re-authentications can unduly burden both users and networks, causing 
i«- f reduction in productivity and degradation in network performance. 

] £j Another shortcoming of some previous access systems is that the services 

H* 10 are provided within the access system and cannot be accessed by other 

l?j applications. Some users may require that an application not part of the access 

system participate in the process of granting access to resources. To accomplish 

1 3ft 

this, a user may wish to program an application to provide a subset of the 
!?j authentication/authorization features, and be able to access various services and 

¥■ 15 data inside the access system. Previous attempts to provide an interface to an 

3 access system have required the application trying to interface with the access 

system to be positioned behind a web agent that is part of the access system. Such 
a configuration is inefficient, increases costs and increases maintenance efforts. 
Some access systems may store a cookie on a client machine to save state 
20 information and assist in future authentication processes. However, prior access 
systems do not provide for an application outside the access system, not having a 
web agent front end, to be able to use the cookie and access the contents of the 
cookie in order to participate in providing authentication or authorization services. 
Therefore, a solution is needed to allow an application that does not have a 
25 web agent front end to interface with an access system. Furthermore, it would be 
additionally advantageous if the application can provide authentication services 
such that users are not forced to unnecessarily provide authentication criteria every 
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time they access protected resources. 



SUMMARY OF THE INVENTION 

The present invention, roughly described, provides for an application 
program interface for an access system that enables an application without a web 
agent front end to use contents of an existing cookie (or other storage mechanism) 
to provide access system services. A web agent is a component (usually software, 
but can be hardware or a combination of hardware and software) that plugs into (or 
otherwise integrates with) a web server (or equivalent) in order to participate in 
providing access services. 

One embodiment of the present invention includes the steps of receiving 
user session state information for a first user, receiving resource request 
information for a first resource and receiving a request to authorize the first user to 
access the first resource. The request to authorize is from an application without a 
web agent front end. The request is received by the access system interface of the 
present invention. In response to the requests, the present invention attempts to 
authorize the first user to access the first resource without requiring the first user to 
re-submit authentication credentials 

In one implementation, the user session state information is encrypted and 
stored in a cookie. The step of receiving user session state information includes 
decrypting the user session state information. The system is also capable of 
receiving a request from the application for unencrypted data from the user session 
state information and providing the unencrypted data from the user session state 
information to the application. In one option, the application does not have access 
to a key to decrypt the data in the user session state information. 

Another embodiment of the present invention includes a method for 
providing access services by an application without a web agent front end The 
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method includes receiving an electronic request from a first user to access a first 
resource. The step of receiving includes receiving information from a cookie. The 
application provides the information from the cookie to an access system interface 
and requests the access system interface to authorize the first user to access the first 

5 resource based on information from the user's request and based on the 
information from the cookie. 

Another embodiment of the present invention includes the steps of 
authenticating a first user, causing user session state information to be stored at a 
client for the first user, and authorizing the first user to access a first protected 

10 resource. Subsequently, the system receives a request from an application without 
a web agent front end to allow the first user to access a second protected resource. 
The step of receiving a request includes receiving the user session state information 
from the application. The system allows the first user to access the second 
protected resource without requiring the first user to re-submit authentication 

15 credentials, if the first user is authorized to access the second protected resource. 

Different embodiments of the present include application program 
interfaces for various programming languages. For example, the present invention 
can provide an interface for Java, C, C++, etc. Note, however, that almost any 
other programming language, tools, scheme, etc. can be supported by the present 

20 invention. 

The present invention can be implemented using hardware, software, or a 
combination of both hardware and software. The software used for the present 
invention is stored on one or more processor readable storage devices including 
hard disk drives, CD-ROMs, DVDs, optical disks, floppy disks, tape drives, RAM, 
25 ROM or other suitable storage devices. In alternative embodiments, some or all of 
the software can be replaced by dedicated hardware including custom integrated 
circuits, gate arrays, FPGAs, PLDs, and special purpose computers. Hardware that 
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can be used for the present invention includes computers, handheld devices, 
telephones (e.g. cellular, Internet enabled, etc.), etc. Some of these devices 
includes processors, memory, nonvolatile storage, input devices and output 
devices. 

These and other objects and advantages of the present invention will appear 
more clearly from the following description in which the preferred embodiment of 
the invention has been set forth in conjunction with the drawings. 

BRIEF DESCRIPTION OF THE DRAWINGS 

Figure 1 is a block diagram depicting the components of one embodiment of 
the present invention. 

Figure 2 is a block diagram depicting the components of the computing 
system that can be used with the present invention. 

Figure 3 is a block diagram depicting the components of a Directory Server. 

Figure 4 is an example of a directory tree structure. 

Figure 5 is a flow chart describing a process for setting up access rules for an 
Identity Management System. 

Figure 6 is a flow chart describing a process for editing an attribute access 

criteria. 

Figure 7 is a flow chart describing a process for configuring localized access. 

Figure 8 is a flow chart describing a process for controlling access to 
attributes in the Identity Management System. 

Figure 9 is a flow chart describing a process for determining access to 
attributes of a target. 

Figure 1 0 is a flow chart describing a process for determining whether there 
is a localized access violation for a class. 

Figure 1 1 is a flow chart describing a process for determining whether there 
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is localized access for an attribute. 

Figure 12 is a flow chart describing a process for modifying an attribute. 
Figure 13 is a flow chart describing the active automation process. 
Figure 14 is a block diagram depicting the components of a Web Gate. 
5 Figure 1 5 is a block diagram depicting the components of an Access Server. 

Figure 16 is a flow chart describing a process for creating a policy domain. 
Figure 17 is a flow chart describing a process for adding an authorization 

rule. 

Figure 1 8 is a flow chart describing a process for adding header variables to 
10 an HTTP request. 

Figure 19 is a flow chart describing a process for adding an authentication 

rule. 

Figure 20 is a flow chart describing a process for configuring an audit rule. 

Figure 21 is a flow chart describing a process for creating a policy. 
15 Figure 22 is a flow chart describing an exemplar process performed by the 

Access System of one embodiment of the present invention. 

Figure 23 is a flow chart describing a process for determining whether a 
particular resource is protected. 

Figure 24 is a flow chart describing a process for mapping a resource with a 
20 policy domain. 

Figure 25 is a flow chart describing a process for retrieving first and second 
level authentication rules. 

Figure 26 is a flow chart describing a process for determining whether a 
resource URL matches a specific policy URL. 
25 Figure 26A is a flow chart describing a process for determining whether a 

resource matches a specific policy using POST data. 

Figure 27 provides a block diagram of a retainer data structure. 

Attorney Docket No.: OBLX-01022US0 BBM 
/oblx/1022/1022.001 



Figure 28 is a flow chart describing authentication. 

Figure 29 is a block diagram depicting various components involved in the 
authentication process. 

Figure 30 is a flow chart describing a process for authentication. 

Figure 3 1 is a flow chart describing a process for retrieving an authentication 
challenge scheme from a Directory Server. 

Figure 32 is a flow chart describing a method for performing basic 
authentication. 

Figure 33 is a flow chart describing the process performed by an Access 
Server to authenticate using a user ID and password. 

Figure 34 is a flow chart describing form authentication. 

Figure 35 is a flow chart describing a process for client certificate 
authentication. 

Figure 36 is a flow chart describing a process for authenticating a user using 
certificates. 

Figure 37 is a block diagram depicting the components of one embodiment 
of an encrypted cookie. 

Figure 38 is a flowchart describing a process for authorization. 

Figure 39 is a flow chart describing the steps performed when passing 
authorization information using POST data. 

Figure 40 is a block diagram of an exemplar HTTP request. 

Figure 41 is a flow chart describing a process for obtaining first and second 
level authorization rules from a Directory Server. 

Figure 42 is a flow chart describing a process for evaluating an authorization 

rule. 

Figure 43 is a flow chart describing a process for applying an authorization 
rule to extracted POST data. 
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Figure 44 is a flow chart describing a process for performing authentication 
success actions. 

Figure 45 is a flow chart describing a process for performing authentication 
and authorization failure actions. 
5 Figure 46 is a flow chart describing a process for performing authorization 

success actions. 

Figure 47 is a flow chart describing a process for using header variables. 
Figure 48 is a flow chart describing the steps performed by the auditing 
module of one embodiment of the present invention. 
10 Figure 49 is a flow chart describing a method for retrieving first and second 

level audit rules. 

Figure 50 is a block diagram depicting one embodiment of components used 
for intrusion detection. 

Figure 5 1 is a flow chart describing a process for detecting intrusions. 
15 Figure 52 is a flow chart describing a process performed at a security server 

as part of a process for detecting intrusions. 

Figure 53 is a flow chart describing a process for flushing/synchronizing 
caches performed by an Access Manager. 

Figure 54 is a block diagram depicting a synchronization record. 
20 Figure 55 is a flow chart describing a process for flushing/synchronizing 

caches performed by an Access Server. 

Figure 56 is a flow chart describing a process for flushing/synchronizing 
caches performed by a Web Gate. 

Figure 57 is a flow chart describing a process for testing access criteria. 
25 Figure 58 is a block diagram of another embodiment of the present 

invention. 

Figure 59 is a flow chart of a process for receiving and acting on a request 
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according to the embodiment of Figure 58. 

Figure 60 is a flow chart of a process for authentication and authorizing 
according to the embodiment of Figure 58. 

Figure 61 is a flow chart of60 is a flow chart of a process for authorizing 
according to the embodiment of Figure 58. 

Figure 62 s a flow chart explaining the process of the single sign-on feature 
of to the embodiment of Figure 58. 

DETAILED DESCRIPTION 
Figure 1 depicts an Access System which provides identity management 
and/or access management for a network. In general, an Access System manages 
access to resources available to a network. The identity management portion of 
the Access System ( hereinafter "the Identity Management System") manages end 
user identity profiles, while the access management portion of the Access System 
(hereinafter "the Access Management System") provides security for resources 
across one or more web servers. Underlying these modules is active automation, a 
delegation and work flow technology. The active automation technology couples 
the Identity and Access Management Systems by facilitating delegation of roles 
and rights, plus providing workflow-enabled management of end user identity 
profiles. A key feature of one embodiment of this system is the centralization of 
the repositories for policies and user identity profiles while decentralizing their 
administration. That is, one embodiment of the system centralizes the policy and 
identity repositories by building them on a directory service technology. The 
system decentralizes their administration by hierarchly delegated Administrative 
roles. Although the Access System of Figure 1 includes an Identity Management 
System and an Access Management System, other Access Systems may only 
include an Identity Management System or only include an Access Management 

Attorney Docket No.: OBLX-01022US0 BBM 
/oblx/1022/1022.001 




-11- 

System. 

Figure 1 is a block diagram depicting one embodiment for deploying an 
Access System. Figure 1 shows web browsers 12 and 14 accessing Web Server 18 
and/or Administration Server 20 via Internet 16. In one embodiment, web 
5 browsers 12 and 14 are standard web browsers known in the art running on any 
suitable type of computer. Figure 1 depicts web browsers 12 and 14 communicating 
with Web Server 24 and Administration Server 20 using HTTP over the Internet; 
however, other protocols and networks can also be used. 

Web Server 1 8 is a standard Web Server known in the art and provides an 
10 end user with access to various resources via Internet 16. In one embodiment, 
there is a first firewall (not shown) connected between Internet 1 6 and Web Server 
18, a second firewall (not shown) connected between Web Server 18 and Access 
Server 34. 

Figure 1 shows two types of resources: resource 22 and resource 24. 

1 5 Resource 22 is external to Web Server 1 8 but can be accessed through Web Server 
1 8. Resource 24 is located on Web Server 18. A resource can be anything that is 
possible to address with a uniform resource locator (URL see RFC 1738). A 
resource can include a web page, software application, file, database, directory, a 
data unit, etc. In one embodiment, a resource is anything accessible to a user on a 

20 network. The network could be the Internet, a LAN, a WAN, or any other type of 
network. Table 1, below, provides examples of resources and at least a portion of 
their respective URL syntax: 







Directory 


/Sales/ 
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HTML Page 


/Sales/Collateral/index.html 


CGI Script with no query 


/cgi-bin/testscript.cgi 


CGI Script with query 


/cgi_bin/testscript.cgi?button=on 


Application 


/apps/myapp . exe 



A URL includes two main components: a protocol identifier and a resource 
name separated from the protocol identifier by a colon and two forward slashes. 
The protocol identifier indicates the name of the protocol to be used to fetch the 
resource. Examples includes HTTP, FTP, Gopher, File and News. The resource 
name is the complete address to the resource. The format of the resource name 
depends on the protocol. For HTTP, the resource name includes a host name, a file 
name, a port number (optional) and a reference (optional). The host name is the 
name of the machine on which the resource resides. The file name is the path 
name to the file on the machine. The port number is the number of the port to 
which to connect. A reference is a named anchor within a resource that usually 
identifies a specific location within a file. Consider the following URL: 
"http://www.oblix.com/oblix/sales/index.html. " The string "http" is the protocol 
identifier. The string "www.oblix.com" is the host name. The string 
"/oblix/sales/index.html" is the file name. 

A complete path, or a cropped portion thereof, is called a URL prefix. In 
the URL above, the string "/oblix/sales/index.html" is a URL prefix and the string 
"/oblix" is also a URL prefix. The portion of the URL to the right of the host name 
and to the left of a query string (e.g. to the left of a question mark, if there is a 
query string) is called the absolute path. In the URL above, 
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"/oblix/sales/index.html" is the absolute path. A URL can also include query data, 
which is typically information following a question mark. For example, in the 
URL: 

http://www.obhx. com/oblix/sales/^^ 
the query data is "user=smith&dept=sales." Although the discussion herein refers 
to URLs to identify a resource, other identifiers can also be used within the spirit of 
the present invention. 

Figure 1 shows Web Server 1 8 including Web Gate 28, which is a software 
module. In one embodiment, Web Gate 28 is a plug-in to Web Server 18. Web 
Gate 28 communicates with Access Server 34. Access Server 34 communicates 
with Directory Server 36. 

Administration Server 20 is a web-enabled server. In one embodiment, 
Administration Server 20 includes Web Gate 30. Other embodiments of 
Administration Server 20 do not include Web Gate 30. Administration Server 20 
also includes other software modules, including User Manager 38, Access 
Manager 40, and System Console 42. Directory Server 36 is in communication 
with User Manager 38, Access Manager 40, System Console 42, and Access Server 
34. Access Manager 40 is also in communication with Access Server 34. 

The system of Figure 1 is scalable in that there can be many Web Servers 
(with Web Gates), many Access Servers, and multiple Administration Servers. In 
one embodiment, Directory Server 36 is an LDAP Directory Server and 
communicates with other servers/modules using LDAP over SSL. In other 
embodiments, Directory Server 36 can implement other protocols or can be other 
types of data repositories. 

The Access Management System includes Access Server 34, Web Gate 28, 
Web Gate 30 (if enabled), and Access Manager 40. Access Server 34 provides 
authentication, authorization, and auditing (logging) services. It further provides 
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for identity profiles to be used across multiple domains and Web Servers from a 
single web-based authentication (sign-on). Web Gate 28 acts as an interface 
between Web Server 18 and Access Server 34. Web Gate 28 intercepts requests 
from users for resources 22 and 24, and authorizes them via Access Server 34. 
Access Server 34 is able to provide centralized authentication, authorization, and 
auditing services for resources hosted on or available to Web Server 18 and other 
Web Servers. 

Access Manager 40 allows administrators access to manage multiple 
resources across an enterprise and to delegate policy administration to the persons 
closest to specific business applications and content. In one embodiment, 
administrators perform these tasks using an intuitive graphical user interface 
("GUI"). 

User Manager 38 provides a user interface for administrators to use, 
establish and/or manage identity profiles. An identity profile (also called a user 
profile or user identity profile) is a set of information associated with a particular 
user. The data elements of the identity profile are called attributes. In one 
embodiment, an attribute may include a name, value and access criteria. In one 
embodiment, an identity profile stores the following attributes: first name, middle 
name, last name, title, email address, telephone number, fax number, mobile 
telephone number, pager number, pager email address, identification of work 
facility, building number, floor number, mailing address, room number, mail stop, 
manager, direct reports, administrator, organization that the user works for, 
department number, department URL, skills, projects currently working on, past 
projects, home telephone, home address, birthday, previous employers and 
anything else desired to be stored by an administrator. Other information can also 
be stored. In other embodiments, less or more than the above-listed information is 
stored. 

Attorney Docket No.: OBLX-01022US0 BBM 
/oblx/1022/1022.001 



-15- 

System Console 42 provides a GUI for administrators to perform various 
tasks such as managing Administration roles, managing various system wide 
settings, and configuring the Identity and Access Management Systems. System 
Console 42 can be used to manage groups (optional) and departing users, reclaim 
unused resources, manage logging, configure parameters for authentication, 
configure parameters for authorization, and so on. Additionally, System Console 
42 can be used to configure user schemes and control access to certain Identity 
Management System capabilities (such as "new user," "deactivate user/' 
"workflow," and so on). 

The system of Figure 1 is used to protect a web site, network, Intranet, 
Extranet, etc. To understand how the system of Figure 1 protects a web site (or 
other structure), it is important to understand the operation of unprotected web 
sites. In a typical unprotected web site, end users cause their browsers to send a 
request to a Web Server. The request is usually an HTTP request which includes a 
URL. The Web Server then translates, or maps, the URL into a file system's name 
space and locates the matching resource. The resource is then returned to the 
browser. 

With the system of Figure 1 deployed, Web Server 1 8 (enabled by Web 
Gate 28, Access Server 34, and Directory Server 36) can make informed decisions 
based on default and/or specific rules about whether to return requested resources 
to an end user. The rules are evaluated based on the end user's profile, which is 
managed by the Identity Management System. In one embodiment of the present 
invention, the general method proceeds as follows. An end user enters a URL or 
an identification of a requested resource residing in a protected policy domain. 
The user's browser sends the URL as part of an HTTP request to Web Server 1 8. 
Web Gate 28 intercepts the request. If the end user has not already been 
authenticated, Web Gate 28 causes Web Server 18 to issue a challenge to the 
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browser for log-on information. The received log-on information is then passed 
back to Web Server 18 and on to Web Gate 28. Web Gate 28 in turn makes an 
authentication request to Access Server 34, which determines whether the user's 
supplied log-on information is authentic or not. Access Server 34 performs the 
authentication by accessing attributes of the user's profile and the resource's 
authentication criteria stored on Directory Server 36. If the user's supplied log-on 
information satisfies the authentication criteria, the process flows as described 
below; otherwise, the end user is notified that access to the requested resource is 
denied and the process halts. After authenticating the user, Web Gate 28 queries 
Access Server 34 about whether the user is authorized to access the resource 
requested. Access Server 34 in turn queries Directory Server 36 for the appropriate 
authorization criteria for the requested resource. Access Server 34 retrieves the 
authorization criteria for the resource and, based on that authorization criteria, 
Access Server 34 answers Web Gate 28 's authorization query. If the user is 
authorized, the user is granted access to the resource; otherwise, the user's request 
is denied. Various alternatives to the above described flow are also within the 
spirit and scope of the present invention. 

In one embodiment, the system of Figure 1 includes means for providing 
and managing identity profiles, and means for defining and managing 
authentication and authorization policies. In one implementation, user identity and 
authentication/authorization information is administered through delegable 
Administration roles. Certain users are assigned to Administration roles, thus 
conferring to them the rights and responsibilities of managing policy and/or user 
identities in specific portions of the directory and web name spaces. The capability 
to delegate Administration duties enables a site to scale administratively by 
empowering those closest to the sources of policy and user information with the 
ability to manage that information. 
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A role is a function or position performed by a person in an organization. 
An administrator is one type of role. In one embodiment, there are at least five 
different types of administrators: System Administrator, Master Access 
Administrator, Delegated Access Administrator, Master Identity Administrator, 
5 and Delegated Identity Administrator. A System Administrator serves as a super 
user and is authorized to configure the system deployment itself and can manage 
any aspect of the system. 

A Master Access Administrator is assigned by the system administrator and 
is authorized to configure the Access Management System. The Master Access 

10 Administrator can define and configure Web Gates, Access Servers, authentication 
parameters, and policy domains. In addition, Master Access Administrators can 
assign individuals to Delegated Access Administrator roles. A Delegated Access 
Administrator is authorized to create, delete and/or update policies within their 
assigned policy domain (described below), and create new policy domains 

15 subordinate to their assigned policy domains. A Delegated Access Administrator 
may also confer these rights to others. A Master Identity Administrator, assigned 
by the System Administrator, is authorized to configure the Identity Management 
System, including defining and configuring end user identities and attributes, per 
attribute access control, who may perform new user and deactivate (revocation) 

20 user functions. Master Identity Administrators may also designate individuals to 
Delegate Identity Administrator roles. A Delegated Identity Administrator is 
selectively authorized to perform new user and deactivate user functions. 

A policy domain is a logical grouping of Web Server host ID's, host names, 
URL prefixes, and rules. Host names and URL prefixes specify the course-grain 

25 portion of the web name space a given policy domain protects. Rules specify the 
conditions in which access to requested resources is allowed or denied, and to 
which end users these conditions apply. Policy domains contain two levels of 

Attorney Docket No.: OBLX-01022US0 BBM 
/oblx/1 022/1022.001 



-18- 

rules: first level default rules and second level rules contained in policies. First 
level default rules apply to any resource in a policy domain not associated with a 
policy. 

A policy is a grouping of a URL pattern, resource type, operation type 
(such as a request method), and policy rules. These policy rules are the second 
level rules described above. There are two levels of rules available (first and 
second levels) for authentication, authorization, and auditing. Policies are always 
attached to a policy domain and specify the fine-grain portion of a web name space 
that a policy protects. In practice, the host names and URL prefixes from the 
policy domain the policy belongs to are logically concatenated with the policy's 
URL pattern and the resulting overall patterns compared to the incoming URL. If 
there is a match, then the policy's various rules are evaluated to determine whether 
the request should be allowed or denied; if there is not a match, then default policy 
domain rules are used. 

Figure 2 illustrates a high level block diagram of a computer system which 
can be used for the components of the present invention. The computer system of 
Figure 2 includes a processor unit 50 and main memory 52. Processor unit 50 may 
contain a single microprocessor, or may contain a plurality of microprocessors for 
configuring the computer system as a multi-processor system. Main memory 52 
stores, in part, instructions and data for execution by processor unit 50. If the 
system of the present invention is wholly or partially implemented in software, 
main memory 52 can store the executable code when in operation. Main memory 
52 may include banks of dynamic random access memory (DRAM) as well as high 
speed cache memory. 

The system of Figure 2 further includes a mass storage device 54, 
peripheral device(s) 56, user input device(s) 60, portable storage medium drive(s) 
62, a graphics subsystem 64 and an output display 66. For purposes of simplicity, 
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the components shown in Figure 1 are depicted as being connected via a single bus 
68. However, the components may be connected through one or more data 
transport means. For example, processor unit 50 and main memory 52 may be 
connected via a local microprocessor bus, and the mass storage device 54, 
5 peripheral device(s) 56, portable storage medium drive(s) 62, and graphics 
subsystem 64 may be connected via one or more input/output (I/O) buses. Mass 
storage device 54, which may be implemented with a magnetic disk drive or an 
optical disk drive, is a non- volatile storage device for storing data and instructions 
for use by processor unit 50. In one embodiment, mass storage device 54 stores the 
1 0 system software for implementing the present invention for purposes of loading to 
main memory 52. 

Portable storage medium drive 62 operates in conjunction with a portable 
non-volatile storage medium, such as a floppy disk, to input and output data and 
code to and from the computer system of Figure 2. In one embodiment, the system 

15 software for implementing the present invention is stored on such a portable 
medium, and is input to the computer system via the portable storage medium drive 
62. Peripheral device(s) 56 may include any type of computer support device, such 
as an input/output (I/O) interface, to add additional functionality to the computer 
system. For example, peripheral device(s) 56 may include a network interface for 

20 connecting the computer system to a network, a modem, a router, etc. 

User input device(s) 60 provide a portion of a user interface. User input 
device(s) 60 may include an alpha-numeric keypad for inputting alpha-numeric and 
other information, or a pointing device, such as a mouse, a trackball, stylus, or 
cursor direction keys. In order to display textual and graphical information, the 

25 computer system of Figure 2 includes graphics subsystem 64 and output display 
66. Output display 66 may include a cathode ray tube (CRT) display, liquid crystal 
display (LCD) or other suitable display device. Graphics subsystem 64 receives 
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textual and graphical information, and processes the information for output to 
display 66. Additionally, the system of Figure 2 includes output devices 58. 
Examples of suitable output devices include speakers, printers, network interfaces, 
monitors, etc. 

5 The components contained in the computer system of Figure 2 are those 

typically found in computer systems suitable for use with the present invention, 
and are intended to represent a broad category of such computer components that 
are well known in the art. Thus, the computer system of Figure 2 can be a personal 
computer, workstation, server, minicomputer, mainframe computer, or any other 

10 computing device. The computer can also include different bus configurations, 
networked platforms, multi-processor platforms, etc. Various operating systems 
can be used including Unix, Linux, Windows, Macintosh OS, Palm OS, and other 
suitable operating systems. 

Figure 3 is a block diagram of Directory Server 36. Directory Server 36 

15 stores user identity profiles 102. Each identity profile includes a set of attributes 
for the particular end users. Group information 1 04 is also stored, which describes 
logical relationships and groupings of users having identity profiles 102 stored on 
Directory Server 36. A plurality of policies 1 06, each of which is associated with a 
policy domain as described above, are also stored on Directory Server 36. 

20 Revoked user list 1 08 identifies users previously (but no longer) allowed access to 
resources on their system. Shared secret(s) 110 are keys stored on Directory 
Server 36 used for encrypting cookies set on browsers 12 or 14 after a successful 
user authentication. Shared secret(s) (keys) 1 10 can change as often as desired by 
an administrator. In one embodiment of the present invention, previously valid 

25 keys are "grandfathered" such that both a current key and an immediately prior key 
will de-crypt encrypted cookies. Global sequence number (GSN) 1 12 is a unique 
number stored on Directory Server 36 which is assigned to a policy domain 
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change (first level default rules) or policy change (second level resource-specific 
rules) and updated in response to subsequent policy changes for cache flushing 
purposes. In one embodiment of the present invention, the GSN is incremented to 
the next sequential number after detection of a policy domain or policy change. 
5 User attribute list 1 1 4 is a list of user identity profile attributes used by cached 
authentication and authorization rules. 

Figure 4 depicts an exemplar directory tree that can be stored on Directory 
Server 36. Each node on the tree is an entry in the directory structure. Node 1 30 is 
the highest node on the tree and represents an entity responsible for the directory 

10 structure. In one example, an entity may set up an Extranet and grant Extranet 
access to many different companies. The entity setting up the Extranet is node 
130. Each of the companies with Extranet access would have a node at a level 
below node 130. For example, company A (node 1 32) and company B (node 1 34) 
are directly below node 130. Each company may be broken up into organizations. 

15 The organizations could be departments in the company or logical groups to help 
manage the users. For example, Figure 4 shows company A broken up into two 
organizations: organization A with node 136 and organization B with node 138. 
Company B is shown to be broken up into two organizations: organization C with 
node 140 and organization D with node 142. Figure 4 shows organization A 

20 having two end users: employee 1 with node 150 and employee 2 with node 152. 
Organization B is shown with two end users: employee 3 with node 154 and 
employee 4 with node 156. Organization C is shown with two end users: employee 
5 with node 158 and employee 6 with node 160. Organization D is shown with 
two end users: employee 7 with node 162 and employee 8 with node 164. 

25 Each node depicted in Figure 4 can include one or more identity profiles 

stored in Directory Server 36. In one embodiment, there are different types of 
object-oriented classes for storing information for each identity profile. One 
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exemplar class pertains to entities such as entity 1 30, company A (node 133), and 
company B (node 134). A second exemplar class stores information about 
organizational units such as organization A (node 136), organization B (node 138), 
organization C (node 140), and organization D (node 142). In one embodiment, 
each of the organizations are departments in a company and each of the users are 
employees who work for that particular organization. A third exemplar class is for 
individual persons such as employee 1 (node 150), employee 2, (node 152), . . . 
employee 8 (node 164). Although the directory tree is depicted as having three 
levels, more or less than three levels can be used. 

In a typical use of the Identity Management System shown in Figure 4, a 
source from the Identity Management System attempts to access a target in the 
Identity Management System. For example, employee 1 (node 150) may seek to 
access the profile for employee 4 (node 156). Thus, node 150 is the source and 
node 156 is the target. For efficiency purposes, one embodiment stores access 
information at the target and at the highest level for targets with common access 
rules. In some cases, access information is stored at a higher level even if a lower 
level does not include common access rules. 

Figure 5 is a flow chart describing the process for setting up an identity 
profile by an administrator having authority to do so. In step 200, the administrator 
selects the object class to be used for the directory entry or entries being created. 
As previously described, there are at least three classes: organization, 
organizational unit, and user. In step 200, the master identity administrator selects 
which class is to be used for the entry. After the object class is selected in step 
200, all possible attributes for the particular class appear on a graphical user 
interface (GUI) (step 202). In step 204, the administrator selects one of the 
attributes. In step 206, the master identity administrator edits the access criteria for 
the attribute. In step 2 1 0, it is determined whether there are any more attributes to 
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consider. If so, the method loops back to step 204. Otherwise, the process of 
Figure 5 is completed (step 214). 

Figure 6 is a flow chart describing step 206 of Figure 5, editing access 
criteria for an attribute. In step 230, the administrator selects where in the tree 
5 structure of Figure 4 to store the access information for the particular attribute 
under consideration. For example, if the administrator is setting up an identity 
profile for employee 2 (node 1 52) of Figure 4, attribute access information can be 
stored at node 152, node 136, node 132, or node 130. In step 230, it is determined 
which one of those available nodes will store the information. In step 232, the 

10 permissions to modify the attribute are set up using a policy. A policy can identify 
person(s) who can modify the attribute. The policy can identify a set of people by 
identifying a role, by identifying a rule for identifying people, by identifying one or 
more people directly by name, or by identifying a named group. In step 236, 
permissions are set up to determine who can view the attributes. The Identity 

15 Management System policy determines which users can view identity profile 
attributes by defining a role, defining a rule, identifying persons by name, or listing 
an identified group. In one embodiment, the rule mentioned above is an LDAP 
rule. In step 238 (an optional step), the ability to edit the permissions are delegated 
to others. In step 240, a notify list is set up. The notify list identifies a set of zero 

20 or more persons who are notified (e.g. by email) when the attribute is modified. 

In one embodiment, the Identity Management System includes a localized 
access feature. This feature restricts certain user's access to identity profiles within 
a defined locale. For example, if an entity sets up an Extranet similar to the tree of 
Figure 4, and allows two of its suppliers (e.g. company A and company B) to 

25 access the Extranet, company A may not want employees from company B to 
access identity profiles for employees of company A. In accordance with the 
present invention, a set of identity profiles can be defined as a locale. Users 
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outside the locale can be restricted from accessing identity profiles inside the 
locale. Alternatively, users outside the locale can be restricted from accessing 
certain attributes of identity profiles inside the locale. The localized access feature 
can be used to prevent any nodes, including node 132 and any nodes below node 
1 32, from accessing node 1 34 and any node below node 1 34. The localized access 
feature can be used at other levels of granularity and/or at other levels of the 
organizational hierarchy. For example, users below node 1 36 can be blocked from 
accessing profiles below node 138, node 140, node 142, node 134, etc. 

Figure 7 is a flow chart describing the process for configuring localized 
access. In step 262, a localized access parameter for the entire system of Figure 1 
is set. This parameter turns on the localized access function. In step 266 of Figure 
7, a class attribute can be set for localized access. Each identity profile has a set of 
attributes. One of those attributes is designated as the class attribute. The class 
attribute is used to identify the identity profile. A reference to a particular identity 
profile is a reference (or pointer) to the class attribute for the identity profile. The 
class attribute can be configured for localized access by setting up a localized 
access filter that identifies the locale. If the source of a request is in a different 
locale than the locale defined for the class attribute, then the source is denied 
access to the target. The localized access filter can be an absolute test such as 
"Company=Acme" or the filter can name another attribute (called a domain 
attribute). If the filter names a domain attribute (e.g. company attribute, address 
attribute, last name attribute, organization attribute, etc. ), then the filter is satisfied 
if the named attribute for source matches the named attribute for the target. For 
example, if the domain attribute named for the class attribute is "Company Name," 
than a source can only access a target if the company name for the source is the 
same as the company name for the target. Using a domain attribute, rather than 
hard coding the criteria, is more dynamic because it depends on the run-time 
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relationship of the source and target. In one embodiment, multiple domain 
attributes can be used to define the locale. Users whose domain attributes are 
equal, are in the same locale. A user can be a member of multiple locales. 

In step 268, individual attributes for a profile can be configured for 
localized access. That is, some attributes in an identity profile can be configured 
for localized access, while other attributes are not. Each attribute can be provided 
with a localized access filter that identifies the locale for that attribute. The 
localized access filter can include an absolute test, an LDAP test or one or more 
domain attributes. In one embodiment, individual attributes are not configured in 
step 268 if the class attribute for the profile has already been set. It is possible to 
configure the class attribute for localized access and not configure the other 
attributes for localized access. Similarly, in some embodiments it is possible to 
not configure the class attribute for localized access while configuring the other 
attributes for localized access. 

In one embodiment, when a source seeks to access a particular attribute in a 
target, the system first checks to see if the localized access filter for the class 
attribute of the target is satisfied. If it is not satisfied, then access is denied. If it is 
satisfied, then the system first checks to see if the localized access filter for the 
particular attribute of the target is satisfied. If it is or it is not configured for 
localized access, then access can be granted. If the localized access filter for the 
particular attribute of the target is not satisfied, access to the particular attribute is 
denied. In summary, the localized access filter for the class attribute determines 
access to the entire identity profile, while the localized access filter for a specific 
attribute (other than the class attribute) determines access to the specific attribute. 
After the steps of Figure 7 are completed, the profiles (or portions of profiles) that 
have been set for localized access can only be accessed by those within the same 
locale. 
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Figure 8 is a flow chart describing the process for accessing data in the 
Identity Management System. The data can be accessed for viewing, modifying, 
etc. As described above, the entity attempting to access a profile in the Identity 
Management System is the source and the profile being accessed is the target. In 
step 290, the source user's browser sends a request to access attributes of a target 
directory entry. In step 292, the request is received by User Manager 38. Instep 
294, User Manager 38 accesses the target profile and the source profile on 
Directory Server 36. In step 296, User Manager 38, based on the attribute settings 
created or modified by the process of Figure 5 and (possibly) the source profile, 
determines whether the source should have access to each of the different attributes 
of the target profile. This step is discussed in further detail below. In step 298, 
User Manager 38 passes the information for the attributes that access is allowed for 
to the source's browser. In step 300, the attributes that the source may view are 
displayed on the source's browser. 

Figure 9 is a flow chart describing the process of step 296 of Figure 8, 
determining whether the source should have access to the various attributes of the 
target. In step 320, the system determines whether a localized access violation for 
the class attribute has occurred. A localized access violation is found when the 
target's class attribute is configured for localized access and the source is not in the 
locale for the target. If there is a localized access violation, the method of Figure 9 
is done (step 344) and none of the attributes for the target may be accessed by the 
source. For example, if the source is employee 1 (node 150 of Figure 4), the target 
is employee 8 (node 164 of Figure 4), and all of company B is subject to localized 
access with a domain attribute set as "company " (in one embodiment the actual 
syntax is %company%) a localized access violation will be found in step 320. 

If no localized access violation is found in step 320, then one of the 
attributes for the target is selected in step 322 and User Manager 38 determines 
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whether the access information for that selected attribute is at the current level in 
the tree. The first time step 324 is performed, the current level in the tree is the 
level of the target. As previously explained, access information can be stored at 
the target's node or nodes above the target. If the access information is not found 
5 at the current level, then in step 340, it is determined whether the system is 
inquiring at the top level of the directory structure (e.g. node 130 of Figure 4). If 
the system is at the top level, then the system determines whether all attributes 
have been evaluated in step 332. If all attributes have been evaluated, then the 
process of Figure 9 is done (step 348). If all attributes have not been evaluated, 

10 then the system accesses the initial level again in step 334 and loops back to step 
322. If in step 340, it is determined that the system is not at the top level, then the 
system moves up one level (step 342) and loops back to step 324. 

While in step 324, if the access information for the attribute is at the current 
level being considered, then in step 326 it is determined whether there is a local 

15 access violation for the attribute under consideration. If the particular attribute 
being considered was configured for localized access and the source is not in the 
relevant locale for the target, then a localized access violation occurs and the 
method of Figure 9 is done (step 346). It will be appreciated that localized access 
can apply to entire profiles or only certain portions (certain attributes) of profiles. 

20 If the attribute under consideration was not configured for localized access, then 
there is no localized access violation for the attribute under consideration. If there 
is no localized access violation for the attribute under consideration, then the 
identity profile for the source is applied to any additional access criteria to see 
whether the source should have access to the target's attribute. If the criteria is 

25 met, access is granted in step 330 and the method loops to step 332. At the end of 
the process of Figure 9, a source will be granted access to zero or more attributes. 
Step 300 of Figure 8 displays only those attributes for which the source has been 
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granted access. 

Figure 10 is a flow chart describing the process of step 320 in Figure 9, 
determining whether a localized access violation has occurred for a class attribute. 
In step 360, the Identity Management System determines whether the localized 
access parameter is set. If not, there is no localized access violation. If so, then in 
step 364, the system determines whether a class attribute is configured for localized 
access. If the class attribute is not configured for localized access, there is no local 
access violation (step 362). If the class attribute is configured for localized access, 
then in step 366 it is determined whether the localized access filter is satisfied (e.g. 
does the domain attribute for the target must match the domain attribute for the 
source?). If the localized access filter is satisfied, no localized access violation 
occurs (step 362). If the localized access filter is not satisfied, then a localized 
access violation exists and access should be denied (step 368). 

Figure 1 1 is a flow chart describing the process performed in step 326 of 
Figure 9, determining whether there is a localized access violation for a particular 
attribute. In step 380, it is determined whether a localized access parameter is set. 
If not, thee is no localized access violation (step 382). Otherwise, in step 384, it is 
determined whether the particular attribute is configured for localized access. If 
the particular attribute is not configured for localized access, then there is no 
localized access violation (step 382). If the particular attribute is configured for 
localized access, then in step 386 it is determined whether the localized access 
filter for the attribute under consideration is satisfied. If the localized access filter 
is satisfied, then there is no localized access violation (step 382). If the localized 
access filter is not satisfied, then there is a localized access violation and access 
should be denied (step 388). 

Figure 12 is a flow chart describing the process of how a source user can 
modify an attribute of a target profile. In step 410, the source user attempts to 
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modify an attribute. For example, in one embodiment the source user is provided a 
GUI which depicts the directory tree. The source user can select any node in the 
directory tree and click on a button to modify a target profile. Alternatively, the 
source user can type in a URL, distinguished name, or other identifying 
5 information for the target. Once presented with a target profile (e.g. the process of 
Figure 8), the user selects a particular attribute and attempts to modify it by 
selecting a modify button on the GUI. This request to modify is sent to User 
Manager 38. Instep 412, User Manager 3 8 searches for the modify criteria for the 
■zg\ attribute in the target directory. This modify criteria is the information set up in 

■SB 

10 step 232 of Figure 6. User Manager 38 searches in the current target directory. If 
the criteria is not found in the current directory being accessed (see step 4 1 4), then 

Q 

kQ it is determined whether the system is at the top of the directory tree structure (step 

I ah 

416). If not, then the system moves up one level in step 418. If the top of the 
*3 directory structure is reached, then the source user is not allowed to modify the 

w 

ly 15 attribute (step 420). In step 422, User Manager 38 searches for the modify criteria 

Ji"| in a new directory. After step 422, the method loops back to step 414. If in step 

H' 414, it is determined that the criteria was found at the current level being 

considered, then in step 430, the User Manager evaluates the criteria against the 
target user's identity profile. If the identity profile for the target user satisfies the 
20 criteria for modifying the attribute (step 432) then the source user is allowed to 
modify the attribute (step 434). Otherwise, the source user is not allowed to 
modify the attribute (step 420). 

Figure 13 is a flow chart describing a process for automating the updating 
of identity profiles when a source user requesting the update is not allowed to 
25 modify the target profile. In one embodiment, the source user is the person 
identified by the target profile. In step 450, the source user requests modification 
of the target profile. This can be a request to modify any or all of the attributes for 
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the target profile (e.g. address, telephone number, creation of the profile, deletion 
of the profile, etc.). In step 452, it is determined whether the target profile is 
protected. It is possible to set all attributes such that any source entity can modify 
the attributes In such a configuration; the profile is not protected. If the target 
profile is not protected, then, in step 454, the target profile is modified as per the 
source user's request. If the target profile is protected, then in step 456, the User 
Manager 38 issues an electronic message ("ticket") sent to a responsible party 
requesting that the modification be made. The responsible party is a person 
granted access to modify a particular attribute and has the responsibility for doing 
so. In step 458, the ticket appears in a service queue accessible by the responsible 
party. The service queue can be a directory which stores all tickets or can be any 
database which is used to store the tickets. The responsible party may access a 
GUI which indicates all tickets in the service queue, the date they were received, 
and what service is requested. In step 460, the requesting source user can view 
whether a ticket has been serviced. In step 462, the ticket is fully serviced, 
partially serviced or denied by the responsible party. If the ticket is serviced, then 
the target will be modified. However, the target will not be modified if the ticket is 
denied. After the target is modified (or purposely not modified) and a ticket is 
responded to, the ticket is removed from the service queue in step 464. In an 
optional embodiment, the source is automatically notified that the ticket is removed 
from the service queue and notified of the result of the request. 

Figure 14 provides a block diagram of Web Gate 28. In one embodiment, 
Web Gate 28 is a Web Server plug-in running on Web Server 18. In another 
embodiment, Web Gate 28 is an NSAPI Web Server plug-in. In another 
embodiment, Web Gate 28 is an ISAPI Web Server plug-in. In still a further 
embodiment, Web Gate 28 is an Apache Web Server plug-in. In another 
embodiment, a plurality of Web Gates conforming to different plug-in formats are 
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distributed among multiple Web Servers. 

Resource cache 502 caches authentication information for individual 
resources. The information stored in resource cache 502 includes: request method, 
URL, retainer 505, and audit mask 503. In one embodiment of the present 
invention, audit mask 503 is a four bit data structure with separate bits identifying 
whether authentication and/or authorization successes and/or failures are audited 
(logged) for a given resource. 

Authentication scheme cache 506 stores authentication scheme information, 
including information necessary for the performance of each different 
authentication challenge scheme. For example, if the authentication scheme ED 
parameter of a resource cache 502 entry references a "client certificate 1 ' 
authentication scheme, then the authentication scheme ID parameter of the entry 
would reference an authentication scheme cache 506 entry (keyed by the 
authentication challenge method ID). In one embodiment, authentication scheme 
cache stores redirect URL, authentication challenge method ID (identifying an 
authentication challenge method), challenge parameters for authentication and 
authentication level. Web Gate 28 also stores the most recent global sequence 
number 510 received from Access Server 34 pursuant to a cache flushing 
operation, as further described below. 

Event manager 514 calls redirection event handler 504, resource protected 
event handler 508, authentication event handler 5 12, or authorization event handler 
5 1 6 to perform redirection, a resource protected method, an authentication method, 
or an authorization method (all further described herein), respectively. Redirection 
event handler 504 redirects browser 12 or 14 in response to redirection events 
initiated by Access Server 34 or other components of Web Gate 28. Resource 
protected event handler 508 performs steps in a method for determining whether a 
requested resource falls protected within a policy domain. Authentication event 
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handler 512 performs steps in a method for authenticating a user of browser 12 or 
14 upon a finding that a requested resource is protected. Authorization event 
handler 516 performs steps in a method for determining whether a user of browser 
12 or 14 is authorized to access a requested resource upon a successful 
authentication or receipt of a valid authentication cookie, further described herein. 
Sync record table 518 identifies all existing synchronization records not yet 
processed by Web Gate 28 as further described herein. 

Figure 15 provides a block diagram of Access Server 34. Authentication 
module 540 is provided for carrying out steps in a method for authenticating a user 
as further described herein. Authorization module 542 is provided for carrying out 
steps in a method for authorizing a user to access a requested resource as further 
described herein. Auditing module 544 carries out steps in a method for auditing 
(logging) successful and/or unsuccessful authentications and/or authorizations as 
further described herein. Audit logs 546 store information logged by auditing 
module 544 in accordance with the present invention. Audit logs sensors 548 
include one or more sensors that monitor the audit logs for certain types of events. 
Synchronization records 550 are stored on Access Server 34 in accordance with a 
method for flushing caches as further described herein. 

Access Server 34 stores the most recent global sequence number 554 
received from Access Manager 40 pursuant to a cache flushing operation. URL 
prefix cache 564 stores the URL prefixes associated with policy domains that are 
protected by the Access Management System. URL prefix cache 564 facilitates the 
mapping of requested resources to policy domains, as further described herein. 
URL prefix cache 564 is loaded from Directory Server 36 upon initialization of 
Access Server 34. 

Policy domain cache 566 caches all default authentication rules of each 
policy domain in accordance with the present invention. Policy domain cache 
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further stores an array of rules 565 listing all default and resource-specific rules 
associated with resources in a given policy domain. Each rule entry in array 565 
includes the ID of the rule and compiled information about the URL pattern 
(resource) to which the rule applies. Array 565 enables Access Server 34 to 
quickly find the first level default authentication, authorization, and auditing rules 
for a given policy domain, as well as second level rules (authentication, 
authorization, and auditing rules) associated with particular policies in the policy 
domain. 

Authentication scheme cache 568 caches information necessary for the 
performance of different authentication challenge methods as similarly described 
above for authentication scheme cache 506 of Web Gate 28. Authentication rule 
cache 570 caches second level authentication rules associated with policies. The 
rules in authentication rule cache 570 are listed in array 565. Upon determining 
that a second level authentication rule exists and learning its ID (by looking in 
array 565), Access Server 34 can easily find the second level authentication rule in 
authentication rule cache 570. The second level rules are the rules associated with 
policies, discussed above. 

Authorization rule cache 572 caches first level default authorization rules as 
well as second level authorization rules. The rules in authorization rule cache 572 
are listed in array 565. Upon determining that a first or second level authorization 
rule exists and learning its ID (by looking in array 565), Access Server 34 can 
easily find the applicable authorization rule for a given resource in authorization 
rule cache 572. 

Audit rule cache 574 caches first level default audit rules as well as second 
level audit rules. The rules in audit rule cache 574 are listed in array 565. Upon 
determining that a first or second level audit rule exists and learning its ID (by 
looking in array 565), Access Server 34 can easily find the applicable audit rule for 
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a given resource in audit rule cache 574. 

User profile cache 576 stores identity profile attributes previously used in 
authentications, authorization, or audit steps, in accordance with the present 
invention. User policy cache 578 stores the successful and unsuccessful 
5 authorization results for specific users requesting specific resources governed by 
authorization rules based on an LDAP filter or a group membership. User policy 
cache 578 allows Access Server 34 to quickly recall a user's authorization if the 
user has recently accessed the resource. 

Figure 16 is a flow chart which describes the process of creating a policy 

10 domain. In step 600, System Console 42 (or Access Manager 40) receives a 
request to create a policy domain. In step 602, the name of the policy domain and 
the description of the policy name are stored. In step 604, one or more URL 
prefixes are added to the policy domain. In step 605, one or more host ID's are 
added to the policy domain (optional). Next, one or more access rules are added to 

15 the policy domain. An access rule is a rule about accessing a resource. Examples 
of access rules include authorization rules, authentication rules, auditing rules, and 
other rules which are used during the process or attempting to access a resource. 
In step 606, a first level (default) authentication rule is added to the policy domain. 
In general, authentication is the process of verifying the identity of the user. 

20 Authentication rules specify the challenge method by which end users requesting 
access to a resource in the policy domain must prove their identity (authentication). 
As previously discussed, first level (default) authentication rules apply to all 
resources in a policy domain, while second level authentication rules are associated 
with policies that apply to subsets of resources or specific resources in the policy 

25 domain. In one embodiment, there is only one default authentication rule for a 
policy domain. If an administrator desires an authentication rule to apply to only a 
specific resource in the policy domain, a separate policy for that specific resource 
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having a second level (specific) authentication rule should be defined, as discussed 
below. After setting up the authentication rule in step 606, one or more first level 
or default authorization rules are added to the policy domain in step 608. In 
general, an authorization rule determines who can access a resource. The default 
5 authorization rule allows or denies users access to resources within its applicable 
policy domain. If multiple authorization rules are created, then they are evaluated 
in an order specified in step 610. In step 612, a first level (default) audit rule is 
configured for the policy domain. In step 614, zero or more policies are added to 
the policy domain. In step 616, the data for the policy domain is stored in 

10 Directory Server 36 and appropriate caches (optional) are updated. In one 
embodiment, an authorization rule or an authentication rule can be set up to take no 
action. That is, always grant authentication without any challenge or verification; 
or always grant authorization without any verification. 

Figure 1 7 is a flow chart describing the process of adding one or more 

15 authorization rules to a policy domain (step 608 of Figure 1 6). In step 632, timing 
conditions are set up for the authorization rule. Timing conditions restrict the time 
when the authorization rule is in effect. For example, users can be allowed access 
to URLs in the policy domain only during business hours, Monday through Friday. 
In one embodiment, if timing conditions are not set, the authorization rule is 

20 always in effect. The timing conditions include selecting a start date, an end date, 
selecting a start time and an end time, selecting the months of the year, selecting 
the days of the month, and selecting the days of the week that the rule is valid. In 
steps 634 and 636, authorization actions are set up. Authorization actions 
personalize the end user's interaction with the Web Server. In step 634, header 

25 variables are provided for authorization success events and authorization failure 
events. This feature allows for the passing of header variables about the end user 
(or other information) to other web-enabled resources. Web-enabled applications 
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can personalize the end user's interaction with the Web Server using these header 
variables. As a simple example, the actions could supply each application with the 
user's name. An application could then greet the user with the message "hello < 
user's name >" whenever the user logs on. Header variables are variables that are 
part of an HTTP request. Figure 40 below illustrates the format of an HTTP 
request that includes header variables 1 554. If an authorization rule is set up with 
header variables as part of an authorization success action, then when a successful 
authorization occurs the HTTP request to the resource will include the header 
variables. Similarly, if there are header variables for an authorization failure, then 
an authorization failure event will include adding header variables to the HTTP 
request that redirects a browser to an authorization failure web page. The resources 
identified by the HTTP requests, that include the header variables can use the 
header variables any way desired. In one embodiment of the method of Figure 17, 
one or more groups can be specified for authorization to the resource(s). 

Figure 18 is a flow chart that describes the process of adding header 
variables to an HTTP request (see step 634 of Figure 17). Header variables can be 
added during an authorization success event, authorization failure event, 
authentication success event or authentication failure event. In step 650, the 
variable name is entered. In step 652, a text string is entered. In step 654, one or 
more LDAP attributes are entered. In step 656, it is determined whether any more 
header variables will be added. If not, the method of Figure 1 8 is done (step 658). 
If so, the method of Figure 18 loops back to step 650. 

The variable name entered in step 650 is a value that appears in the HTTP 
header that names the variable. The downstream resource using the header 
variable will search for the variable name. The string entered is data that can be 
used by the downstream resource. The LDAP attribute(s) can be one or more 
attributes from the requesting user's identity profile. Thus, in the simple 
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authorization success example described above, the variable name field can include 
"authorization success," the return field can include "yes," and the attribute field 
can include the name attribute for the user in the user's identity profile. Any of the 
attributes from the user's identity profile can be selected as a header variable. 

Looking back at Figure 17, in step 636, a redirect URL can be added for an 
authorization success event and a redirect URL can be entered for an authorization 
failure event. Step 638 includes specifying which users are allowed to access the 
resource associated with the authorization rule. By default, users cannot access a 
resource until they are granted access rights to it. In one embodiment, there are at 
least four means for specifying who can access a resource. The first means is to 
explicitly name a set of users who can access the resource. A second means 
includes identifying user roles. The third means is to enter an LDAP rule that can 
be used to identify a set of users based on a combination of one or more attributes. 
A fourth means is to enter an IP address which will allow users of computers 
having the specified IP address to access the resource. Step 640 is used to specify 
the users not allowed to access the resource associated with this rule. Identification 
of users, roles, LDAP rules, and LP addresses are entered in step 640 in the same 
manner as entered in step 638. It is possible that a particular user can be subject to 
both an allow access rule and a deny access rule. Step 642 is used to set a priority 
between such rules. Optional step 644 is used to define any POST data to be used 
for authorization if this feature is implemented. An HTTP POST request can 
include POST data in the body of the HTTP request (see Figure 40 below). POST 
data can also be submitted in query string form. One embodiment of the present 
invention allows POST data to be used for authorization purposes. In optional step 
644, an administrator defines which POST data is to be used for authorization 
purposes. If POST data is to be used for authorization, in order for an 
authorization rule to be satisfied, the POST request must include all the appropriate 
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POST data and values for that POST data as defined in step 644. However, it will 
be understood that POST data need not be used for authorization in all 
embodiments of the present invention. Step 646 is used to set a priority of 
evaluation for the authorization rule relative to other authorization rules in a given 
policy. In one embodiment, if multiple authorization rules apply to a resource, this 
priority determines the order of evaluation. 

Figure 19 is a flow chart describing the process for adding an authentication 
rule (see step 606 of Figure 16). In step 670, a challenge scheme (also called an 
authentication scheme) is selected. An authentication scheme is a method for 
requesting log-on information (e.g. name and password) from end users trying to 
access a web resource. Within an authentication scheme is a challenge method 
(e.g. Basic, certificate or form). There can be more than one authentication scheme 
with the same challenge method (e.g. Basic over LDAP, Basic over NT Domain, . . 
.). Various other authentication schemes can also be used. In step 672, header 
variables are added for authentication success and authentication failure events. In 
step 674, redirect URLs are added for authentication success events and 
authentication failure events. 

Figure 20 provides a flow chart depicting the process for configuring an 
audit rule (see step 612 of Figure 1 6). In step 680, the events to trigger an audit are 
selected. In one embodiment, authentication success, authentication failure, 
authorization success and authorization failure can be selected for auditing. In step 
682, the information to be logged is selected for each particular event identified in 
step 680. The information logged can include information about the event and/or 
user attributes from the identity profile for the user requesting the authentication or 
authorization. 

Figure 2 1 is a flow chart describing the process of adding a policy (see step 
614 of Figure 16). In step 718, a resource type is specified. The resource type 
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allows different resources to be handled by different policies, depending on the 
nature of the resource itself For example, in one embodiment, the resource type 
will distinguish between resources accessed using HTTP and resources accessed 
using FTP. In another embodiment, Enterprise Java Beans (EJBs) are a possible 
resource type. In another embodiment, user-defined custom resource types are 
supported. In step 720, an operation type is specified. This allows different 
resources to be handled by different policies, depending on the operations used to 
request the resource. In one embodiment, the operations will be HTTP requests. 
Supported HTTP request methods include GET, POST, PUT, HEAD, DELETE, 
TRACE, OPTIONS, CONNECT, and OTHER. In another embodiment, if EJBs 
are identified as the resource type (step 718), an EXECUTE operation can be 
specified in step 720. In another embodiment, user-defined custom operations are 
supported. Other and future operations can also be supported. In step 722, a pattern 
for the URL path to which the policy applies is specified. This is the part of URL 
that does not include the scheme ("http") and host/domain ("www.oblix.com"), and 
appears before a character in the URL. In step 724, a query string is specified. 
This is a set of variables and values that must be included in the specified order in 
an incoming URL for the policy to match and be activated. For example, in the 
URL "HTTP ://www. zoo.com/animals. cgi?uid=maneaters&tigers=2" the values 
after the question mark (e.g. "uid=maneaters&tigers=2") comprise a query string. 
Only a URL exhibiting the query string can match to this policy. For example, a 
URL with the "tigers" variable appearing before the "uid" variable will not match 
the above-identified policy. In step 726, query string variables are added. Query 
string variables include a name of a variable and the variable's corresponding 
value. Query string variables are used when it is a desirable that multiple variables 
are found in the query string, but the order is unimportant. Thus, for a policy with 
query string variables "uid=maneaters" and "tigers=2," a URL with a query string 
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having the appropriate uid and appropriate tigers variable, in any order, will match 
the policy. In order for a resource URL to apply to a policy, the path of the 
requested resource URL must match the path of the policy as well as any query 
string or query variables. As discussed above, POST data can be submitted in 
query siring form (for example, in a form submission), and evaluated using the 
query string variables entered in step 726. 

The query string or query variables specified in the steps of Figure 21 do 
not need to uniquely identify a resource. Rather, they are used to identify a policy, 
which may apply to one or more resources. 

Typically, the query data is added to a URL to access certain data from a 
resource. However, the query data can be used in the URL to identify the resource. 
Each application or resource is free to use the query data in any way that is in 
agreement with standards and norms known in the art. 

In step 728 of Figure 21, the authentication rule is created in accordance 
with the method of Figure 19. In step 730, one or more authorization rules are 
created for the policy in accordance with the method of Figure 1 7. In step 732, an 
audit rule for the policy is configured in accordance with the method of Figure 20. 
In step 734, POST data (optional) is added to the policy. This POST data is used to 
map resources with policies. 

The present invention supports the use of multiple authentication schemes. 
An authentication scheme comprises an authentication level, a challenge method, 
an SSL assertion parameter, a challenge redirect parameter, and authentication 
plug-ins. The authentication level represents an arbitrary designation of the level 
of confidence that an administrator has in a particular authentication scheme 
relative to other authentication schemes. 

In one embodiment of the present invention, an authentication 
scheme can specify one of four challenge methods: none, basic, form, and X.509. 
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If an authentication scheme's challenge method is set to "none," no authentication 
is required to access a requested resource, thus allowing support for 
unauthenticated users. This challenge method can be used over both unsecured as 
well as SSL connections. The "basic" challenge method can also be used over both 
unsecured and SSL connections. The "X.509" challenge method can only be used 
over an SSL connection between a user's browser and Web Server host, because 
the authentication method invoked for an X509 challenge method is part of the 
SSL protocol. A "form" challenge method employs a custom, site-specific HTML 
form presented to the user, who enters information and submits the form. 
Subsequent processing is determined by the administrator at the time the 
authentication scheme is created. Form challenge methods can be used over both 
unsecured and SSL connections. 

The SSL parameter of an authentication scheme identifies whether SSL is 
to be asserted on the connection to the user's browser by the Web Server. The 
challenge parameter identifies where to redirect a request for authentication for the 
particular authentication scheme. Authentication plug-ins are necessary for 
processing the user's supplied information. Authentication plug-ins can interface 
with Access Server 34 through an authentication API. 

An authentication scheme that an attacker can easily and profitability 
eavesdrop upon is typically considered "weak." In one embodiment, the basic 
authentication challenge method places the user's credential (supplied 
information), a simple password, "in the clear" over an unsecured network 
connection. However, the authentication scheme can be made stronger by passing 
the user's credential over an encrypted connection, such as SSL. In one 
embodiment, given two authentication schemes (one with and one without SSL), 
an access administrator will assign the authentication scheme without SSL to a 
lower authentication level than the authentication using SSL. 
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When a user first request a protected resource, the user is challenged 
according to the authentication scheme defined by the first level authentication rule 
in the applicable policy domain or the second level authentication rule in the 
applicable policy associated with the requested resource. If the user satisfies the 
authentication rule, an encrypted authentication cookie is passed to the user's 
browser indicating a successful authentication. Once authenticated, the user may 
request a second resource protected by a different policy domain and/or policy with 
a different authentication rule. The user will be allowed access to the second 
resource without re-authenticating if the authentication level of the authentication 
scheme used to successfully authenticate for the first resource is equal to or greater 
than the authentication level of the authentication scheme of the second resource. 
Otherwise, the user is challenged and asked to re-authenticate for the second 
resource in accordance with the second resource's higher level authentication 
scheme. Satisfaction of a higher or lower authentication level is determined by 
evaluating the authentication cookie sent by the user's browser when requesting the 
second resource. In one embodiment of the present invention, administrators can 
define an unlimited number of authentication levels. 

Once authenticated, a user can explicitly log out, causing authentication 
cookies cached (or otherwise stored) by the user's browser to be destroyed or 
become invalid. Authentication cookies can also be set by an administrator to be 
destroyed after a maximum idle time has elapsed between requests to resources 
protected in accordance with the present invention. 

Figure 22 provides a flow chart for one embodiment of a method for 
authenticating, authorizing, and logging. In step 750, a user's browser 12 requests 
a web-enabled resource 22 or 24. The request is intercepted by Web Gate 28 in 
step 752. The method then determines whether the requested resource is protected 
by an authentication and/or authorization rule in step 753. If the resource is not 
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protected, then access is granted to the requested resource in step 795. If the 
requested resource is protected however, the method proceeds to step 754. If the 
user has previously authenticated for a protected resource in the same domain, a 
valid authentication cookie will be passed by browser 12 with the request in step 
750 and intercepted by Web Gate in step 752. If a valid cookie is received (step 
754), the method attempts to authorize the user in step 756. If no valid 
authorization cookie is received (step 754), the method attempts to authenticate the 
user for the requested resource (step 760). 

If the user successfully authenticates for the requested resource (step 762), 
then the method proceeds to step 774. Otherwise, the unsuccessful authentication 
is logged in step 764. After step 764, the system then performs authentication 
failure actions and Web Gate 28 denies the user access to the requested resource in 
step 766. In step 774, the successful authentication of the user for the resource is 
logged. The method then performs authentication success actions in step 766. In 
response to the successful authentication, Web Gate 28 then passes a valid 
authentication cookie to browser 12 in step 780 which is stored by browser 12. 
After passing the cookie in step 780, the system attempts to authorize in step 756. 

In step 756, the method attempts to determine whether the user is 
authorized to access the requested resource. If the user is authorized (step 790), the 
method proceeds to step 792. Otherwise, the unsuccessful authorization is logged 
in step 796. After step 796, the method performs authorization failure actions (step 
798) and Web Gate 28 denies the user access to the requested resource. If 
authorization is successful (step 790), then the successful authorization of the user 
is logged in step 792, authorization success actions are performed in step 794, and 
the user is granted access to the requested resource in step 795. In one 
embodiment of step 795, some or all of HTTP request information is provided to 
the resource. 
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Figure 23 provides a flow chart of a method for determining whether a 
requested resource is protected (see step 753 of Figure 22). In one embodiment, 
the steps of Figure 23 are performed by resource protected event handler 508 and 
Access Server 34. In step 830, Web Gate 28 determines whether an entry for the 
requested resource is found in resource cache 502. If an entry is found, the cache 
entry is examined in step 842 to determine whether the cache entry indicates that 
the resource is protected (step 832) or unprotected (step 840). If an entry for the 
requested resource is not found in resource cache 502, then Web Gate 28 passes the 
URL of the requested resource request method to Access Server 34 in step 833. 
Access Server 34 attempts to map the requested resource to a policy domain using 
URL prefix cache 564 (step 836). 

If mapping step 836 is unsuccessful (step 838), then the requested resource 
is deemed to be unprotected (step 840). However, if a successful mapping has 
occurred (step 838), then Access Server 34 retrieves the authentication rule (step 
844) and audit rule (step 846) associated with the requested resource. Access 
Server 34 then passes the authentication scheme ID from the authentication rule, 
audit mask 503, retainer 505 and any POST data received to Web Gate 28 in step 
848. Web Gate 28 caches the authentication scheme ED from the authentication 
rule, audit mask 503, retainer 505 and POST data in resource cache 502 (step 850). 
Since the requested resource was successfully mapped to a policy domain in step 
836, the resource is deemed protected (step 832). 

Figure 24 is a flow chart describing the process for mapping a resource to a 
policy domain (see step 836 of Figure 23). In step 900, Access Server 34 receives 
the URL of the requested resource from Web Gate 28. Access Server 34 then 
compares a URL prefix of the requested resource with entries in URL prefix cache 
564 in step 902. In one embodiment, when step 902 is called for the first time in 
Figure 24, the URL prefix of the requested resource equals the file name. Thus, if 
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the URL of the requested resource reads: 

"http://www.oblixxoiri/oblix/sales/index.html" then the URL prefix first compared 
by step 902 will be: "/oblix/sales/index.html." If a matching URL prefix is found 
(step 904), Access Server 34 proceeds to step 916. 

5 In step 916, Access Server 34 determines whether the policy domain 

associated with the matching URL prefix calls for one or more host ED's. In one 
embodiment, resources are mapped to certain policy domains if the port number of 
a resource request and the location of the resource itself conform to one or more 
host ID's. Thus, multiple policy domains can be associated with identical URL 

10 prefixes, each policy domain requiring different host BD's (or none at all). If the 
policy domain considered in step 916 requires a matching host ID, then Access 
Server 34 proceeds to step 917. Otherwise, Access Server 34 proceeds directly to 
step 906 where the requested resource is mapped to the policy domain associated 
with the currently considered URL prefix. In step 917, if a matching host ID is 

15 found, Access Server 34 proceeds to step 906. If no matching host ID is found, 
Access Server 34 returns to step 904 where it determines whether additional 
matching URL prefixes exist. 

If no matching URL prefix is found in step 904, then Access Server 34 
proceeds to step 908. In step 908, Access Server 34 crops the right-most term from 

20 the resource URL prefix compared in step 902. Thus, if the resource URL prefix 
compared in step 902 reads: ' Voblix/sales/index.htmF' then the resource URL prefix 
will be cropped in step 908 to read: "/oblix/sales." If the entire resource URL 
prefix has been cropped in step 908 such that no additional terms remain (step 
910), then the method proceeds to step 912 where Access Server 34 concludes that 

25 there is no policy domain associated with the requested resource. However, if one 
or more additional terms remain in the resource URL prefix, then the method 
returns to step 902 where the cropped URL prefix is compared with URL prefixes 
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cached in URL prefix cache 564. 

As will be apparent from Figure 24, the method recursively performs steps 
902, 904, 908, and 910 until either a match is found (step 904) or the entire 
resource URL prefix has been cropped (step 910). In any case, the method of 
Figure 24 will inevitably return either a successful mapping (step 906) or no 
mapping (step 912). 

Figure 25 provides a flow chart describing a method for loading an 
authentication rule (see step 844 of Figure 23). In step 930, Access Server 34 loads 
the first level (default) authentication rule for the policy domain mapped in step 
836 of Figure 23 from Directory Server 36 into authentication rule cache 570. In 
one embodiment, success and failure actions are part of all authentication and 
authorization rules. In one embodiment, Access Manager 40 maintains a user 
attribute list 1 14 on Directory Server 36. User attribute list 114 identifies all user 
attributes used by authentication and authorization actions loaded into 
authentication rule cache 570 and authorization rule cache 572. In this step, 
Access Server 34 also builds array 565 (previously described above) and loads it 
into policy domain cache 566. Array 565 includes all second level rules and 
patterns associated with each of the policies for the policy domain. Access Server 
34 then selects a second level rule in array 565 (step 931). The selected second 
level rule is part of a policy. In step 932, Access Server 34 performs a pattern 
matching method (further described below) for determining whether the rule 
applies to the requested resource. If so, then Access Server 34 proceeds to step 
935; otherwise, Access Server 34 determines whether all rules in array 565 have 
been evaluated (step 933). If, in step 933, it is determined that not all of the rules 
in the array have been evaluated, then Access Server 34 selects the next rule in 
array 565 (step 934) and returns to step 932. Once all rules in array 565 have been 
considered (step 933), the first level authentication rule previously loaded in step 
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930 is returned as the authentication rule, no second level authentication rule is 
loaded into authentication rule cache 570, and the method of Figure 25 is done 
(step 937). If an associated policy was found in step 932, then authentication 
module 540 caches the second level authentication rule and success and failure 
actions for the rule in authentication rule cache 570 (step 935), returns that second 
level authentication rule (step 936), and the method is done (step 937). 

Figure 26 is a flow chart describing a method for determining whether a 
policy is associated with a resource (see step 932 of Figure 25). A policy URL can 
contain the following three types of patterns. All three types of patterns were 
referenced in Figure 21 : 

1. Pattern on the path of the URL: This is the part of URL that does 
not include the scheme ("http") and host/domain ("www.oblix.com' 1 ), and appears 
before a character in the URL. In the example URL: 

http://www.oblix.com/oblix/sales/index.html?user^J.Smith&dept=engg 
the absolute path is "/oblix/sales/index.html." 

2. Pattern on name value pairs in the URL: This may be a set of 
patterns. They apply to query data (data appearing after the character in the URL 
when operation is GET, or the POST data if operation is POST) and are configured 
as name (no pattern allowed) plus a pattern or value. For example: 

variable name pattern 

user * Smith 

dept * sales* 

If multiple name value pairs are specified, they all must match to the incoming 
resource URL. So the URL: 

http://www.oblix.com/oblix/sales/index.html?user=J.Smith&dept=engg 
will not match this pattern set. This pattern does not include a notion of order to 
these name-value pairs. A URL: 
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http://www.oblixxom/oblix/sales/index.html?dept=sales&user=J.SmiA 
(with reverse order of "dept" and "user") will also satisfy this pattern. This is 
important because it is usually difficult to control the order of name value pairs in 
GET/ POST query data. 

3. Pattern on the entire query string: This is useful when an 
administrator desires to enforce an order on the query string. For example, a pattern 
"user=* Smith* sales" will match query string "user=J.Smith&dept=sales." 

A policy can contain one or more of above types of patterns. If multiple 
patterns are specified in one policy, they ALL must match to the incoming resource 
URL. If not, that policy doesn't apply to the incoming resource URL. 

Patterns used for one embodiment of the current invention can use the 
following special characters: 

1. ?: Matches any one character other than 7\ For example, 
"a?b" matches "aab" and "azb" but not "a/b." 

2. *: Matches any sequence of zero or more characters. Does not 
match V 1 . For example, "a*b M matches "ab," "azb," and "azzzzzzb but not "a/b." 

3 . ["set"] : Matches one from a set of characters, "set" can be specified 
as a series of literal characters or as a range of characters. A range of characters is 
any two characters (including '-') with a '-' between them. V 1 is not a valid 
character to include in a set. A set of characters will not match 7 f even if a range 
which includes V is specified. Examples includes: "[nd]" matches only "n" or "d"; 
"[m-x]" matches any character between "m" and "x" inclusive; "[— b]" matches any 
character between "-" and "b" inclusive (except for "/"); "[abf-n]" matches "a," 
"b," and any character between "f 1 and "n" inclusive; and "[a-f-n]" matches any 
character between "a" and "f ' inclusive, or "n." The second "-" is interpreted 
literally because the "f ' preceding it is already part of a range. 

4. {"patternl,""pattern2,"...}: Matches one from a set of patterns. The 
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patterns inside the braces may themselves include any other special characters 
except for braces (sets of patterns may not be nested). Examples includes: 
"a{ab,bc}b" matches "aabb" and "abcb"; "a{x*y,y?x}b" matches "axyb," 
"axabayb," "ayaxb," etc. 

5. "/.../": Matches any sequence of one or more characters that starts 
and ends with the V character. Examples includes: "/.../index .html" matches 
"/index .html," "/oblix/index.html," and "/oblix/sales/index.html," but not 
"index.html," "xyzindex.html," or "xyz/index.html"; and 7oblix/.../*.htmr matches 
"/oblix/index.html," 7oblix/sales/order.html," etc. 

6. "\": Any character preceded by a backslash matches itself. 
Backslash is used to turn off special treatment of special characters. Examples 
include "abc\*d" only matches "abc*d"; and "abcWd" only matches "abc\d." 

To increase the speed of pattern matching, the system tries to do some 
work up front. When Access Server 34 loads a pattern in its cache, it creates an 
object. This object's constructor "compiles" the pattern. This compiling is 
essentially building a simple state machine from one pattern to other, i.e., it creates 
a chain of "glob nodes." Each glob node consists of either one pattern or a node 
set. For example, consider pattern: 
/. . ./abc*pqr {uv,xy* } . 
The chain would look like: 

node(7.../") — > node("abc") ---> node("*") — > node("pqr") 
— >nodeset(node("uv"), (node("xy") — > node("*"))) 

Once the chain is constructed, it is used to match a resource URL to the 
pattern. Each node or node set in this chain takes a pointer to a string, walks it and 
decides if it matches the pattern held by the node. In doing so, it also moves this 
pointer further up in the string. For example, when the server gets a URL 
71/3/abcdepqrxyz," the system takes this string and starts walking the chain. 
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Below is an example of evaluation at each node/ node set and pointer (*p) in the 
string. Note that the original string is not modified. To begin with lets assume that 
the pointer points to the beginning of the string: *p -> "/1/3/abcdepqrxyz.": 

Step 1: node(7.../") — > MATCHES — > advance *p -> "abcdepqrxyz." 
Step 2: node("abc") — > MATCHES — > advance *p -> "depqrxyz." 
Step 3: node("*") — > * matches everything except special characters ( 
unescaped '?,' '*,' '[,' V '{,' '}>' V )> so at this point, the system tries 
matching to the next node, node("pqr") like this: 

a) does *p->"depqrxyz" match node ("pqr")? NO, advance 
*p -> "epqrxyz." 

b) does *p->"epqrxyz M match node ("pqr")? NO, advance *p 
-> "pqrxyz." 

c) does *p-> "pqrxyz" match node ("pqr")? YES, advance *p 
-> "xyz." If we walked to the end of string and didn't find a 
"pqr" ( for example in case of URL "/1/3/abcdefgh" ) there 
is no match. 

Step 4: nodeset(node("uv"), (node("xy") — > node("*"))): A nodeset will 
match incoming string ( in the example, *p -> "xyz" ) to one of set 
members. In this case "xyz" does not match "uv," but it does match 
"xy*." So there is a MATCH and *p -> f \0.' 
Step 5: The pointer is at the end of the string. So the match is successful. 
At any point, if the system finds a node that does not match its string, the system 
stops processing and concludes that the string does not match the pattern. For 
example, a URL 71/3/dddddd" will clear step 1 above, but will fail step2, so the 
matching stops after step 2. 

Referring to Figure 26, in step 940, Access Server 34 retrieves the policy 
information from policy domain cache 566. The policy information can include 
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one or more of the following: a URL absolute path, a query string, and zero or 
more query variables. In step 941 , Access Server 34 determines whether requested 
resource matches the policy resource type (see Figure 21). If the resource type 
does not match, Access Server 34 skips to step 952. However, if the resource type 
does match, Access Server 34 proceeds to step 942. In step 942, Access Server 34 
determines whether the operation used to request the resource matches policy 
operation type (see Figure 21). If the operation type does not match, Access Server 
34 skips to step 952. If the operation type does match, Access Server 34 proceeds 
to step 943. 

In step 943, the policy URL absolute path, query variables, and query 
strings are broken up into various nodes, as described above. In step 944, the 
various nodes are stored. Access Server 34 accesses the requested resource URL 
in step 946. In step 948, the first node of the policy URL is considered by Access 
Server 34. In step 950, Access Server 34 considers whether the considered node 
matches the resource URL, as described above. If the first node does not match, 
then the entire policy will not match (step 952). If the node does match the 
resource URL, or if there are no nodes for the policy, then in step 954 it is 
determined whether there are any more nodes to consider. If more nodes remain to 
be considered, then in step 956 the next node is considered and the method loops 
back to step 950. If there are no more nodes (step 954), the query string for the 
policy is compared to the query string of the resource URL in step 958. If the 
query string for the policy exactly matches the query string for the resource URL, 
or if there is no query string for the policy, then the method continues with step 
960. If the query string for the policy does not match the query string for the 
resource URL, then the resource URL does not match and is not associated with 
the policy (step 952). 

In step 960, it is determined whether there are any query variables (see 
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Figure 21) to consider that have not already been considered. If there are query 
variables to consider, then the next query variable is accessed in step 964. The 
accessed query variable is searched for in the resource URL in step 965. If the 
query variable is found in the resource URL and the value for the query variable 
matches the stored value query variable in for the policy (step 966), then the 
method continues at step 960; otherwise, Access Server 34 proceeds to step 967. 
The purpose of steps 960, 964, 965, and 966 is to determine whether each of the 
query variables (and associated values) defined for a policy are found, in any order, 
in the resource URL. If all of the query variables are in the URL with the 
appropriate values, than there is a match (step 970). In one embodiment, the query 
string and the query variables are in the portion of the URL following the question 
mark. 

If in step 966 a match is not found, then it is determined whether a match 
may still be possible using POST data. In one embodiment, resources are mapped 
to policies by matching POST data submitted with resource requests. Thus, 
different policies can be associated with a given resource, depending on the 
contents of the POST data. For example, a user may request a resource during the 
course of submitting an online form containing POST data. Applicable policies 
can be mapped on the basis of POST data added to the policy in step 734 of Figure 
2 1 . In step 967, Access Server 34 determines whether the policy operation type is 
an HTTP POST request. If not, then there is no match (step 952). However, if the 
operation type is an HTTP POST request, then Access Server 34 proceeds to step 
968 where Access Server 34 requests and receives the POST data from Web Gate 
28. In one embodiment, Web Gate 28 transmits a flag with all POST requests 
forwarded to Access Server 34. When POST data is transmitted with an HTTP 
POST request, the flag is set. If no POST data is transmitted, then the flag is not 
set. In another embodiment, retainer 505 is transmitted by Access Server 34 to 
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Web Gate 28 when requesting POST data. Retainer 505 is returned by Web Gate 
28 to Access Server 34 with the POST data, thus indicating which policy to 
continue evaluating in step 969. In step 969, Access Server 34 evaluates whether 
the POST data received in step 968 matches the POST data required by the policy 
to achieve a match (see Figure 21). If the POST data matches, then the method 
proceeds to step 970. Otherwise, the method proceeds to step 952. 

Figure 26A provides a flow chart detailing the steps performed when 
matching a resource with a specific policy using POST data in step 969 of Figure 
26. In one embodiment, the steps of Figure 26A are performed by authentication 
module 540. In step 980, Access Server 34 selects the first data required for 
matching the policy under consideration. Then, in step 981, Access Server 34 
selects the first item of POST data received in step 968 of Figure 26. Access 
Server 34 compares the POST data with the required data (step 982). If a match is 
found (step 983), Access Server proceeds to step 987. Otherwise, Access Server 
34 proceeds to step 984 where it determines whether all of the POST data received 
has already been compared in step 982. If additional POST data remains to be 
compared, Access Server 34 selects the next item of POST data received (step 986) 
and loops back to step 982. If all received POST data has already been compared 
(step 982) and no match was found (step 984), then Access Server 34 returns no 
match (step 985). In step 987, Access Server 34 determines whether additional 
POST data is required to be matched in order to match the specific policy under 
consideration with the requested resource. If additional data is required, Access 
Server 34 selects the next required data (step 988) and loops back to step 981 . If 
no additional data is required, Access Server 34 returns a match (step 989). 

Figure 27 provides a block diagram of a retainer data structure (retainer) 
505 that is passed by Web Gate 28 to Access Server 34 to identify the policy 
domain and policy previously mapped in step 836 of Figure 23 and step 932 of 
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Figure 25, respectively. Retainer 505 is cached in resource cache 502 in step 850 
of Figure 23. Retainer 505 contains the policy domain ID 992 of the mapped 
policy domain to be used in authorization and logging steps, the policy ID 994 for 
an applicable policy residing in the mapped policy domain, and ID 996 for the 
applicable authentication scheme. Thus, by passing retainer 505 rather than the 
complete URL of the requested resource, Web Gate 28 saves Access Server 34 
from having to repeatedly remap the requested resource to a policy domain and 
policy during authorization and logging. 

Figure 28 provides a flowchart of a method for authenticating a user for 
various combinations of domains and Web Servers through a single authentication 
performed by the user. As will be apparent to those skilled in the art, an Internet 
domain can reside on a single Web Server, or be distributed across multiple Web 
Servers. In addition, multiple Internet domains can reside on a single Web Server, 
or can be distributed across multiple Web Servers. In accordance with the present 
invention, the method of Figure 28 allows a user to satisfy the authentication 
requirements of a plurality of domains and/or Web Servers by performing a single 
authentication. 

In the simplest case, all of an e-business host company's Web Servers will 
be in the same domain (i.e. oblix.com). When a user successfully authenticates at 
one of the Web Servers, the Web Gate running on the authenticating Web Server 
causes the Web Server to return an encrypted cookie, indicating a successful 
authentication. Subsequent requests by the browser to the domain will pass this 
cookie (assuming the cookie applies to the requested URL), proving the user's 
identity; therefore, further authentications are unnecessary. 

In a more complex case, an e-business host company's web presence 
incorporates associated web sites whose Web Servers have names in multiple 
domains. In such a multiple domain case, each of the associated portal Web 
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Servers use a Web Gate plug-in configured to redirect user authentication 
exchanges to the e-business host's designated web log-in Web Server. The user is 
then authenticated at the e-business host's web log-in server, and an encrypted 
cookie is issued for the e-business host's domain to the user's browser. The user's 
browser is then redirected back to the original associated portal's site where the 
Web Gate creates a new cookie for the associated portal's domain and returns it to 
the user's browser. 

As a result, the user is transparently authenticated in both the original 
associated portal's domain and the e-business host's domain. The process is 
transparently performed for each different associated portal that a user may visit 
during a session. The present invention's associated portal support easily supports 
single Web Servers having multiple DNS names in multiple domains, and/or 
multiple network addresses. In accordance with the present invention, this multiple 
domain authentication enables "staging" of web sites. For example, a new edition 
of a web site can be deployed on a separate set of servers, and then mapped to 
policy domains protected by the present invention by simply updating the policy 
domain's host ID's. 

In one embodiment, the steps of Figure 28 are performed by authentication 
event handler 512 and redirection event handler 504. In step 1020, authentication 
event handler 512 determines whether single or multiple domains are protected in a 
given deployment of the present invention. If only a single domain is protected, 
then the method proceeds to step 1022 where an authentication is attempted at the 
single domain. If the single domain is distributed across multiple Web Servers, 
then the domain attribute of the cookie set by the authenticating Web Server in step 
1022 is set to broadly include all Web Servers in the domain. 

If multiple domains are protected, the method proceeds to step 1024 where 
authentication event handler 512 determines whether the multiple protected 
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domains all reside on a single Web Server. For example, a single machine 
intranet.oblix.com may be addressed in multiple ways such as: sifl.oblix.com, 
intranet, asterix.oblix.com, or 192.168.70.1. In accordance with the present 
invention, when multiple domains reside on a single Web Server, an administrator 
5 will designate exactly one of the domains a "preferred host domain." If step 1 024 
indicates that all protected domains reside on the same Web Server, then 
authentication event handler 512 determines whether the domain of the requested 
resource is a preferred host (step 1 026). If it is a preferred host, then authentication 
event handler 512 attempts to authenticate the user at the preferred host domain in 

10 step 1030 (further described below with respect to Figure 30). Otherwise, 
redirection event handler 504 redirects browser 12 to the preferred host domain 
(step 1028) for authentication (step 1030). Referring to step 1024, if the multiple 
protected domains reside on multiple Web Servers, then authentication event 
handler 512 proceeds to step 1032. 

15 In one embodiment, a single policy domain and/or policies are created for 

the preferred host domain while no policy domains or policies are created for the 
other domains residing on the same web server. All resource requests made to any 
of the multiple protected domains residing on the same web server are redirected to 
the preferred host domain, thus requiring the user to authenticate according to the 

20 preferred host domain's policy domain and/or policies. As a result, after 
authentication at the preferred host domain, the user is transparently authenticated 
for all other domains residing on the same web server. When subsequent resource 
requests for resources in domains residing on the same web server are redirected to 
the preferred host domain, the prior successful authentication for the host domain 

25 can be confirmed by the existence of a valid authentication cookie for the preferred 
host domain. If such a cookie exists, then the user need not re-authenticate for the 
requested resource. In one embodiment, if subsequent resource requests made to 
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the preferred host domain (or any of the other domains on the same web server) 
require a higher level of authentication, or if a previously valid authentication has 
expired, the user will be required to re-authenticate at the preferred host domain in 
accordance with the method of Figure 28. 
5 Figure 29 provides a block diagram of a plurality of Web Servers, each 

hosting a different domain accessible by browser 1082. In accordance with the 
present invention, when multiple domains are protected and distributed across 
multiple Web Servers, the administrator will identify exactly one of the domains a 
"master domain.' 1 As identified in Figure 29, Web Server 1070 hosts master 

10 domain A.com, while Web Servers 1072 and 1074 host domains B.com and 
C.com, respectfully. An end user's resource request is illustrated in Figure 29 by 
path 1084 from browser 1082 to Web Server 1072. 

Referring back to Figure 28, if authentication event handler 512 determines 
that the domain of the requested resource is a master domain (step 1032), then 

15 authentication event handler 512 attempts to authenticate at the master domain 
(step 1034). Otherwise, redirection event handler 504 redirects browser 12 to the 
master domain (step 1 036). The user then authenticates at the master domain (step 
1038). The redirection and authentication of steps 1036 and 1038 are illustrated in 
Figure 29 by path 1086. Upon a successful authentication at the master domain, 

20 the master domain Web Server passes an authentication cookie to the user's 
browser (step 1040) and re-directs the user's browser back to the first domain 
accessed by the user (step 1042). Also in step 1042, the master domain passes 
information contained in the master domain authentication cookie to the first 
domain in the query data portion of the redirection URL. Steps 1 040 and 1 042 are 

25 illustrated by paths 1088 and 1090, respectively in Figure 29. In step 1044, the 
Web Gate of the first domain Web Server extracts the master domain 
authentication cookie information from the redirection URL, thus confirming the 
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user's authentication at the master domain and resulting in a successful 
authentication (step 1046). The first domain Web Server (B.com) then sends its 
own authentication cookie to web browser 1082 (as depicted by path 1092) in 
accordance with step 780 of Figure 22, previously described above. Any 
subsequent authentication by browser 1 082 at domain C.com on Web Server 1074 
follows the method of Figure 28. 

Figure 30 provides a flow chart of the method for authenticating, as 
performed in steps 1022, 1030, 1034, and 1038 of Figure 28. In one embodiment, 
the steps of Figure 30 are performed by authentication event handler 512. In step 
1 120, authentication event handler 512 accesses resource cache 502 to determine 
what authentication challenge method is to be used for the given resource. 
Authentication event handler 512 then accesses authentication scheme cache 506 in 
step 1122 to determine whether the authentication scheme associated with the 
requested resource has been previously cached. If the authentication scheme is 
found, authentication event handler 512 determines the specific type of challenge 
method in step 1126. If the challenge scheme was not found in step 1122, 
authentication event handler 512 loads the authentication rule associated with the 
requested resource from Directory Server 36 in step 1 124 (further described below 
in Figure 31), and then proceeds to step 1 126. 

In step 1126, authentication event handler 516 discerns whether the 
authentication challenge scheme retrieved in step 1122 or 1124 calls for basic, 
form, certificate, or no authentication. If the challenge scheme indicates basic 
authentication, then the method proceeds to step 1128 and performs basic 
authentication. If the challenge scheme indicates form authentication, then the 
method proceeds to step 1 130 and performs form authentication. If the challenge 
scheme indicates certificate authentication, then the method proceeds to step 1 132 
and performs certificate authentication. If the challenge scheme indicates that no 
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authentication is required (step 1134), then the user is. not challenged, 
authentication is not performed (in one embodiment, the system skips to step 756 
of Figure 22 and in another embodiment the system skips to step 774 of Figure 22). 

Figure 3 1 provides a flow chart describing the method of loading an 
authentication challenge scheme from Directory Server 36 (step 1124 of Figure 
30). In one embodiment, the steps of Figure 31 are performed by authentication 
event handler 512 and Access Server 34. In step 1160, authentication event 
handler 512 requests the authentication challenge scheme to be read from Access 
Server 34. If the authentication challenge scheme is found in authentication 
scheme cache 568 (step 1162), then Access Server 34 proceeds to step 1168. 
Otherwise, Access Server 34 retrieves the requested authentication challenge 
scheme from Directory Server 36 (step 1 164). Upon retrieval, Access Server 34 
caches the authentication challenge scheme in authentication scheme cache 568 
(step 1 166), and proceeds to step 1 168. In step 1 168, Access Server 34 passes the 
retrieved authentication challenge scheme to Web Gate 28. Web Gate 28 then 
caches the authentication challenge scheme in authentication scheme cache 506 
(step 1170). 

Figure 32 provides an exemplar method for performing basic authentication 
(step 1 128 of Figure 30). In one embodiment, the steps of Figure 32 are performed 
by authentication event handler 512 and authentication module 540. In step 1 202, 
authentication event handler 512 instructs browser 12 to prompt the user for a user 
ID and password. In response, the user enters and the user's bowser submits the 
requested user ID and password (step 1204). In step 1206, Web Gate 28 intercepts 
the user submission and authentication event handler 512 passes the user ID and 
password to Access Server 34, along with retainer 505, thus identifying a policy 
domain and policy applicable to the requested resource. Access Server 
authentication module 540 then authenticates the user using the user ED and 

Attorney Docket No.: OBLX-01022US0 BBM 
/oblx/1022/1022.001 



-60- 

password in step 1208. In step 1210, authentication module 540 returns the 
authentication result, authentication success or failure actions, and any user 
attributes required by the actions to Web Gate 28. 

Figure 33 provides a flow chart describing an exemplar method used by the 
Access Server to authenticate using a user ID and password (step 1208 of Figure 
32). In one embodiment, the steps of Figure 33 are performed by authentication 
module 540. In optional step 1230, authentication module 540 searches user 
profile cache 576 for a user identity profile entry having a user ID attribute 
matching the user ID received from Web Gate 28. User profile cache 576 is a hash 
table of user identity profile attributes that can be used for authentication, 
authorization, or auditing. In one embodiment, the user ID attribute would appear 
in user profile cache 576 if it was previously used in a successful authentication. If 
a match is found (optional step 1232), then authentication module 540 proceeds to 
step 1234. If no match is found, then authentication module 540 proceeds to step 
1236. 

In another embodiment, steps 1230 and 1232 of Figure 33 are not 
performed. In such an embodiment, the method of Figure 33 begins with step 1236 
where it searches user identity profiles 102 in Directory Server 36 (not user profile 
cache 576) for a user identity profile having a user ID attribute matching the user 
ED received from Web Gate 28. If no matching user identity profile attribute is 
found in Directory Server 36 (step 1238), then the method proceeds to step 1241 . 
If a matching user identity profile attribute is found in Directory Server 36 (step 
1238), then authentication module 540 binds to the directory using the 
distinguished name from the matching user identity profile entry and the password 
received from Web Gate 28 (step 1234). If the bind is unsuccessful (step 1240), 
then authentication module 540 proceeds to step 1 241 where it determines whether 
an entry for the current user is found in user profile cache 576. If so, 
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authentication module 540 proceeds to step 1243. Otherwise, authentication 
module 540 retrieves all profile attributes of the current user appearing in user 
attribute list 1 14 and caches them in user profile cache 576 (step 1242). In step 
1243, authentication module 540 returns an unsuccessful authentication result. 

If the bind is successful (step 1240), then authentication module 540 
accesses revoked user list 582 to determine whether the user ID received from Web 
Gate appears on revoked user list 582. If the user ID is on the revoked user list 
(step 1244), authentication module 540 proceeds to step 1241. If the user ID is not 
on the revoked user list, then authentication module 540 determines whether an 
entry for the user is found in user profile cache 576 (step 1250). If not, 
authentication module 540 retrieves all profile attributes of the current user 
appearing in list 114 and caches them in user profile cache 576 (step 1254). If an 
entry was found, the method skips to step 1260. In step 1260, the method returns a 
successful authentication result. 

Figure 34 provides a flow chart describing a method for performing form 
authentication (step 1 130 of Figure 30). In one embodiment, the steps of Figure 34 
are performed by authentication event handler 512, redirection event handler 504, 
browser 12, and authentication module 540. In step 1308, authentication event 
handler 512 sets a "form login" cookie on browser 12. The cookie includes the 
URL of the requested resource. Authentication event handler 512 then redirects 
browser 1 2 to an authentication form URL (step 1310). In step 1312, Web Gate 28 
allows the authentication form referenced by the authentication form URL to pass 
to browser 12. The user then fills out the authentication form (step 1314) and 
transmits (e.g. post data) the information from the authentication form (step 1316), 
passing the form login cookie previously set in step 1308. Authentication event 
handler 512 then extracts the URL of the requested resource from the form login 
cookie (step 1318), and passes the user ED and password filled out by the user in 
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the authentication form (submitted as POST data) to Access Server 34 (step 1320). 

In step 1322, authentication module 540 authenticates the user for the 
requested resource using the user's id and password received from Web Gate 28, 
performing the steps of Figure 33 previously described above. In step 1324, 
5 authentication module 540 returns the authentication result, authentication actions, 
and user attributes to Web Gate 28. Authentication event handler 512 then sets the 
form login cookie (previously set in step 1308) to indicate that the authentication 
process is completed (step 1326). 

Figure 35 is a flow chart describing a method for performing certificate 

10 authentication (step 1132 of Figure 30). In one embodiment of the present 
invention, client certificate authentication is performed using Web Servers 
employing the Netscape Enterprise Server plug-in interface (NSAPI). In another 
embodiment, client certificate authentication is performed for Web Servers 
employing the Microsoft Internet Information Server plug-in interface (ISAPI). In 

15 yet another embodiment, client certificate authentication is performed on a 
plurality of Web Servers, with a first subset of the Web Servers employing NSAPI 
and a second subset employing ISAPL Other Web Servers can also be used. 

In one embodiment, the steps of Figure 35 are performed by authentication 
event handler 512, redirection event handler 504, browser 12, and authentication 

20 module 540. In step 1348, authentication event handler 512 requests Web Server 
18 to perform SSL client certificate authentication on browser 12. In one 
embodiment of the present invention performing client certificate authentication on 
ISAPI Web Servers, authentication event handler 512 redirects browser 12 to a 
special case URL (i.e. cert_authn.dll) that is configured to accept certificates. In 

25 such an embodiment, this redirection occurs within step 1 348. 

In step 1350, Web Server 18, on behalf of Web Gate 28, sends an SSL 
client certificate request along with trusted certificate authorities (CA's) and 
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challenge data to browser 12. Browser 12 then displays a selection box with client 
certificates from trusted CA's, allowing a user of browser 12 to select a certificate 
(step 1352). Browser 12 then returns the selected certificate with challenge data 
signed by a private key to Web Server 1 8 (step 1356). Web Server 1 8 then verifies 
that the challenge data was properly signed by the selected certificate (step 1360) 
and passes a valid certificate to Web Gate 28 (step 1362), which passes the 
certificate to Access Server 34 (step 1363). In step 1364, authentication module 
540 of Access Server 34 then decodes the certificate and maps the certificate 
subject to a valid distinguished name (further described in Figure 36). In step 
1366, authentication module 540 returns the authentication result, authentication 
actions, and user attributes to Web Gate 28. 

Figure 36 provides a flow chart describing a method for authenticating 
using a valid certificate (step 1364 of Figure 35). In one embodiment, the steps of 
Figure 36 are performed by authentication module 540. In optional step 1390, 
authentication module 540 decodes one or more fields of the certificate passed by 
Web Gate 28 in step 1362 of Figure 35. In one embodiment, the user's e-mail 
address is decoded. In step 1392, authentication module 540 searches user profile 
cache 576 for a user identity profile entry having one or more attributes matching 
the decoded field(s). In one embodiment, the user attribute would appear in user 
profile cache 576 if it was previously used in a successful authentication. If a 
match is found (optional step 1394), then authentication module 540 proceeds to 
step 1406. If no match is found, then authentication module 540 proceeds to step 
1396. 

In another embodiment, steps 1390 and 1392 of Figure 36 are not 
performed. In such an embodiment, the method of Figure 36 begins with step 1 396 
where it searches user identity profiles 102 in Directory Server 36 for a user 
identity profile having one or more attributes matching the decoded field(s). If no 
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matching user identity profile attribute is found in Directory Server 36 (step 1 398), 
then the method proceeds to step 1 402 where it determines whether an entry for the 
current user is found in user profile cache 576. If so, authentication module 540 
proceeds to step 1405. Otherwise, authentication module 540 retrieves all profile 
attributes of the current user appearing in user attribute list 114 and caches them in 
user profile cache 576 (step 1404). In step 1405, authentication module 540 
returns an unsuccessful authentication result. If a matching user identity profile is 
found in step 1398, the method proceeds to step 1406. 

In step 1406, authentication module 540 accesses revoked user list 582 to 
determine whether the user identity profile having the matching user attribute 
appears on revoked user list 582. If so, authentication module 540 proceeds to step 
1402. Otherwise, authentication module 540 continues on to step 1410 and 
determines whether an entry for the current user is found in user profile cache 576. 
If not, authentication module 540 retrieves all profile attributes of the current user 
appearing in list 114 and caches them in user profile cache 576 (step 1416). If an 
entry was found, the method skips to step 1422. In step 1422, the;method returns a 
successful authentication result. 

Figure 37 provides a block diagram of an authentication cookie 1450 
passed by Web Gate 28 to browser 12 in step 780 of Figure 22. Cookie 1450 is 
encrypted with a symmetric cipher so that cookies from all instances of Web Gate 
28 in a given deployment of the present invention may be encrypted using the same 
key. This key (shared secret 1 10) is stored on Directory Server 36 and distributed 
to each of the Web Gates 28 by Access Server 34. Shared secret 110 can change as 
often as desired by an administrator. In one embodiment of the present invention, 
cookie 1450 is encrypted using RC4 encryption with a 2048 bit key. As 
previously described, in one embodiment, previously valid keys are grandfathered 
such that both the current key and the immediately prior key will both work to de- 
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crypt encrypted cookie 1450. The present invention features a one-button key re- 
generation function. This function is easily scriptable. 

In one embodiment, the information stored by cookie 1450 includes the 
authentication level 1452 of the authentication scheme used to create the cookie, 
the user ID 1454 of the authenticated user, the IP address 1456 of the authenticated 
user, and session start time 1458 identifying the time at which cookie 1450 was 
created. If the time elapsed since the session start time 1458 exceeds a maximum 
session time, the cookie will become invalid. Idle start time 1460 is also stored, 
which identifies the time when the previous HTTP request for a protected resource 
was made in which cookie 1450 was passed. If the time elapsed since the idle start 
time 1460 exceeds a maximum idle time, the cookie will become invalid. Both of 
these time limits force users to re-authenticate if they have left a session unattended 
for longer than the maximum session or idle times. Cookie 1450 also stores a 
secured hash 1462 of information 1452, 1454, 1456, 1458, and 1460. In one 
embodiment of the present invention, secured hash 1462 is created using an MD5 
hashing algorithm. Most Internet browsers cache a user's supplied authentication 
information during basic and certificate authentication challenge methods, and then 
transparently re-send the information upon receiving an authentication challenge 
from a Web Server. In one embodiment, an administrator can enable a form 
authentication challenge method requiring end users to re-authenticate upon 
expiration of the maximum session or maximum idle time limits. 

Figure 38 provides a flow chart describing a method for attempting to 
authorize a user (step 756 of Figure 22). In one embodiment, the method of Figure 
38 is performed by authorization event handler 516 and authorization module 542. 
In step 1490, authorization event handler 516 of Web Gate 28 passes authorization 
information to Access Server 34. In step 1494, authorization module 542 
determines whether one or more authorization rules associated with the requested 
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resource are found in authorization rule cache 572. If one or more rules are found, 
authorization module 542 proceeds to step 1496. Otherwise, authorization module 
542 retrieves any authorization rules associated with the requested resource from 
Directory Server 36 in step 1498. In one embodiment, authorization success and 
failure actions are retrieved with the authorization rules. After retrieving the 
authorization rules, authorization module 542 proceeds to step 1496 and reads the 
first authorization rule associated with the requested resource from authorization 
rule cache 572. In one embodiment, multiple authorization rules are evaluated in 
an order determined by the priority set in step 646 of Figure 17. In another 
embodiment, second level authorization rules are evaluated prior to first level 
authorization rules. Authorization module 542 applies the authorization rule (step 
1500) to the authorization information previously passed in step 1490. 

If the authorization rule is satisfied in step 1 502, authorization module 542 
determines whether an entry for the user is found in user profile cache 576 (step 
1 504). If so, authorization module 542 proceeds to step 1 508. If not, authorization 
module 542 retrieves all profile attributes of the current user appearing in user 
attribute list 114 (step 1507), and communicates the authorization success actions 
and attributes to Web Gate 28 (step 1508). 

If the authorization rule is not satisfied (step 1502), then authorization 
module 542 determines whether more authorization rules remain to be evaluated 
(step 1509). If more rules remain, the next rule is read (step 1496) and evaluated 
(step 1500). If no more rules remain, authorization module 542 determines 
whether an entry for the user is found in user profile cache 576 (step 1510). If so, 
authorization module 542 proceeds to step 1512. If not, authorization module 542 
retrieves all profile attributes of the current user appearing in user attribute list 114 
(step 1511), and communicates the authorization success actions and attributes to 
Web Gate 28 (step 1512). 
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Figure 39 details the steps performed when passing authorization 
information to Access Server 34 in step 1490 of Figure 38. In one embodiment, 
the steps of Figure 39 are performed by authorization event handler 516. In one 
embodiment, authorization can be performed using POST data. In another 
embodiment, POST data is not used for authorization. If POST data is enabled to 
be used for authorization, then the method of Figure 39 begins with optional step 
1 530. Otherwise, the method begins at step 1 534. If the resource request issued by 
browser 12 in step 750 of Figure 22 employs a POST request method and POST 
data is enabled to be used for authorization (step 1 530), authorization event handler 
516 passes the POST data and retainer 505 to Access Server 34 (step 1536). If the 
resource request does not employ a POST request method or POST data is not 
enabled to be used for authorization (step 1 530), then authorization event handler 
516 passes retainer 505, the request method, the user's distinguished name, the 
user's IP address, and the time of the request to Access Server 34 in step 1534. 

Figure 40 illustrates the format of an HTTP request. As illustrated in 
Figure 40, an HTTP request 1550 comprises request line 1552, zero or more 
headers 1554, blank line 1556, and body 1558 (used only for POST requests). The 
HTTP protocol supports various types of requests. The GET request returns 
whatever information is identified by the request-URI portion of request line 1552. 
The HEAD request is similar to the GET request, but only a server's header 
information is returned. The actual contents of the specified document is not 
returned. This request is often used to test hypertext links for validity, 
accessibility, and recent modifications. The POST request is used for POSTing 
electronic mail, news, or sending forms that are filled in by an interactive user. A 
POST is the only type of request that sends a body. A valid content-linked header 
field is required in POST requests to specify the length of body 1558. Post data 
can include zero or more data elements separated by as depicted by line 1 562. 
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Each data element is of the form variable name = value. 

HTTP request 1550 can contain a variable number of header fields 1 560. A 
blank line 1556 separates header fields 1554 from body 1558. A header field 
comprises a field name, a string and the field value, as depicted in box 1 560. In 
5 one embodiment, the field value is an LDAP attribute. Field names are case 
insensitive. Headers can be divided in three categories: those that apply to 
requests, those that apply to responses, and those that describe body 1558. Certain 
headers apply to both requests and responses. Headers that describe the body can 
appear in a POST request or in any response. 

10 Figure 41 provides a flow chart describing a method for loading an 

authorization rule from the Directory Server (step 1498 of Figure 38). In one 
embodiment, the steps of Figure 41 are performed by authorization module 542. In 
step 1580, Access Server 34 loads the default authorization rule for the policy 
domain mapped in step 836 of Figure 23 from Directory Server 36 into 

15 authorization rule cache 572. Access Server 34 then selects a first rule in array 565 
(step 1582) and determines whether the selected rule is a second level (specific) 
rule of a policy associated with the requested resource (step 1584), by calling the 
method of Figure 26 previously described above. If yes, then Access Server 34 
proceeds to step 1592. Otherwise, Access Server 34 determines whether all rules 

20 in array 565 have been evaluated (step 1 586). If not, then Access Server 34 selects 
the next rule in array 565 (step 1588), and returns to step 1584. Once all rules in 
array 565 have been considered (step 1586), Access Server 34 proceeds to step 
1594 and loops back to step 1586. If a second level authorization rule (a rule 
defined in a policy) was found for the requested resource in step 1584, then 

25 authorization module 540 caches the second level authorization rule in 
authorization rule cache 570 (step 1592) and the method is done (step 1594). If a 
second level policy authorization rule was not found, then the default authorization 
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rule previously loaded in step 1580 remains in authorization rule cache 572, and 
the method is done (step 1594). 

Figure 42 provides a flow chart describing the method of applying an 
authorization rule (step 1500 of Figure 38). In one embodiment, the steps of 
5 Figure 42 are performed by authorization module 542. In one embodiment, 
authorization can be performed using POST data. In another embodiment, POST 
data is not used for authorization. If POST data is to be used for authorization, 
then the method of Figure 42 begins with optional step 1620. Otherwise, the 
method begins at step 1624. In optional step 1620, if the resource request employs 

10 a POST request method, then authorization module 542 proceeds to optional step 
1622 where it applies the authorization rule to the POST data passed in step 1536 
of Figure 39. If the resource request does not employ a POST request method (or 
if POST data is not enabled to be used for authorization), then authorization 
module 542 proceeds to step 1624. If specific users are defined (by distinguished 

15 name) in the authorization rule, authorization module 542 evaluates whether the 
distinguished name of the authenticated user matches the user's distinguished name 
called for by the authorization rule (step 1626). If specific groups are defined in 
the authorization rule (step 1628), authorization module 542 evaluates whether the 
group name of the authenticated user matches the group name called for by the 

20 authorization rule (step 1 630). In one embodiment, the user's group membership is 
cached in user policy cache 578. If specific roles are defined in the authorization 
rule (step 1632), authorization module 542 evaluates whether the role of the 
authenticated user matches the role called for by the authorization rule (step 1 634). 
If specific LDAP rules are defined in the authorization rule (step 1640), 

25 authorization module 542 evaluates whether the LDAP rule matches the LDAP 
rule called for by the authorization rule (step 1 642). In one embodiment, the result 
of the LDAP rule evaluation in step 1642 is cached in user policy cache 578. If 
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specific user IP addresses are defined in the authorization rule (step 1644), 
authorization module 542 evaluates whether the DP address of the authenticated 
user matches the IP address called for by the authorization rule (step 1646). If a 
successful match is found at any point (steps 1627, 1631, 1635, 1643, and 1647), 
the authorization is successful (step 1650). In one embodiment, successful matches 
of groups and LDAP rules are stored in user policy cache 578 in steps 1631 and 
1643. In another embodiment, multiple matches must be found before an 
authorization success is found. If no matches are found, authorization is 
unsuccessful (step 1652). 

Figure 43 provides a flow chart detailing the steps performed when 
applying an authorization rule to POST data in optional step 1 622 of Figure 42. In 
one embodiment, the steps of Figure 43 are performed by authorization module 
542. In step 1 670, Access Server 34 selects the first item of POST data received in 
optional step 1536 of Figure 39. If the selected POST data is of a type that is 
called for by the authorization rule being evaluated (step 1672), then Access Server 
34 evaluates whether the selected POST data matches data required by the 
authorization rule (step 1 674) and determines whether a successful match has been 
found (step 1675). For example, if an authorization rule calls for a user's 
distinguished name, then a distinguished name contained in the POST data will be 
compared with the distinguished name expected by the authorization rule. If the 
selected POST data equals the expected distinguished name, then a successful 
match will be found for the example above. If a match is found (step 1675), 
Access Server proceeds to step 1682 where it returns a successful authorization. 
Otherwise, Access Server proceeds to step 1676. If, in step 1672, it is determined 
that the type of POST data was not called for, then Access Server 34 proceeds 
directly to step 1676. 

In step 1676, Access Server 34 determines whether all of the POST data 
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received in step 1536 has been considered by step 1672. If additional POST data 
remains to be considered (step 1676), Access Server 34 selects the next available 
item of POST data (step 1678) and loops back to step 1672. If no POST data 
remains to be considered and a match still has not been found (step 1676), access 
Server 34 proceeds to step 1684 and returns an authorization failure. 

Figure 44 is a flow chart describing the process of performing 
authentication success actions (step 776 of Figure 22). In step 1700, Web Gate 28 
determines whether there is a redirect URL. As described above, when setting up a 
policy domain or a policy, an administrator can set up a redirect URL for 
authentication success/failure events as well as authorization success/failure events. 
An administrator can also set up various variables to add to an HTTP request 
based on these events. If, in step 1700, it is determined that a redirect URL exists 
for an authentication success event, then in step 1702 it is determined whether 
there are any HTTP variables to add to the HTTP request. If it was determined in 
step 1700 that there was not a redirect URL, then in step 1704, it is determined 
whether there are any HTTP variables to add to the request. If, in step 1 704, it is 
determined that there are HTTP variables to add to the request in response to the 
authentication success event, then in step 1706, the header variables are added. If, 
in step 1704, it is determined that there are no HTTP variables to add to the 
request, then no action is performed (step 1708). If, in step 1702, it is determined 
that there are no HTTP variables to add to the request, then in step 1710 the 
redirect URL is added to the HTTP request and browser 12 is redirected using the 
HTTP request in step 1712. If in step 1702 it is determined that there are HTTP 
variables to add to the request, then in step 1714 the redirect URL is added to the 
HTTP request and, in step 1716, the header variables are added to the HTTP 
request. In step 1718, the browser is redirected using the newly constructed HTTP 
request. 
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When a Web Server receives an HTTP request, the Web Server stores the 
contents of the HTTP request in a data structure on the Web Server. A Web Gate 
can edit that data structure using an API for the Web Server. In one embodiment, 
the downstream application that will be using the header variables is on, accessed 
using or associated with the same Web Server storing the HTTP request. In that 
case, the header variable are added (e.g. in step 1706) by storing the header 
variables in the data structure on the Web Server. Subsequently, the Web Server 
will provide the header variables to the downstream application. 

Figure 45 is a flow chart describing the steps of performing authentication 
and authorization failure actions (see steps 766 and 798 of Figure 22, respectively). 
In step 1738, Web Gate determines whether there is a redirect URL for the 
authorization failure or authentication failure, whichever event is being considered. 
If there is no redirect URL, then in step 1740, it is determined whether there are 
any HTTP variables for the authorization failure or authentication failure. If there 
are no HTTP variables, then in step 1 742, a default failure URL is added to a new 
HTTP request. The default failure URL is a URL that points to a web page that 
notifies a user that access is denied to the resource. In other embodiments, other 
pages can be used as default failure pages. In step 1744, the user's browser 12 is 
redirected using the HTTP request that includes the default failure URL. If, in step 
1 740, it is determined that there are HTTP variables to add to the HTTP request for 
the particular authentication failure or authorization failure event, then in step 
1746, those variables are added as header variables to the HTTP request. In step 
1 748, the default failure URL is added to the HTTP request. The user's browser is 
redirected using the HTTP request in step 1750. 

If, in step 1738, it is determined that there is a redirect URL for the 
particular authentication failure or authorization failure event, then it is determined 
whether there are any HTTP variables for this particular action in step 1 752. If not, 
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the redirect URL is added to the HTTP request in step 1754 and the browser is 
redirected using the HTTP request in step 1756. If, in step 1752 it is determined 
that there are HTTP variables to add to the request, then in step 1758, the redirect 
URL is added to the HTTP request. In step 1 760, the header variables are added to 
the HTTP request. The user's browser is then redirected using the HTTP request in 
step 1762. 

Figure 46 is a flow chart describing the process of performing authorization 
success actions (step 794 of Figure 22). In step 1782, it is determined whether 
there is a redirect URL for the authorization success action. If there is no redirect 
URL, then in step 1784 it is determined whether there are any HTTP header 
variables to add. If so, the header variables are added in step 1786. For example, 
the header variables can be added to the data structure for the request that is stored 
on the Web Server. Subsequently, the Web Server will provide the header 
variables to the downstream application(s). If, in step 1784 it is determined that 
there are no HTTP variables to add to the request, then no action is taken. 

If it is determined in step 1782 that there is a redirect URL, then in step 
1 796, it is determined whether there are any HTTP variables to add to the request. 
If there are not any HTTP variables to add to the request, then the redirect URL is 
added to the HTTP request in step 1798. In step 1800, the user's browser is 
redirected using the HTTP request with the redirect URL. If it is determined that 
there are HTTP variables to add to the request in step 1 796, then the redirect URL 
is added to the HTTP request in step 1802. In step 1804, the HTTP variables are 
added as header variables to the HTTP request. In step 1 806, the user's browser is 
redirected using the HTTP request. 

Figure 47 is a flow chart describing the process of how a downstream 
application or other resource uses header variables provided by the system of 
Figure 1 . Upon authorization success, authorization failure, authentication success 
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or authentication failure, various data can be added as header variables. In step 
1 830, the resource receives the request. In one embodiment, the resource receives 
request information from a Web Server. In another embodiment, the resource 
receives a redirected HTTP request. In step 1832, the resource determines whether 
5 there are any header variables to consider. If there are no header variables, then in 
step 1 834, the resource responds to the request. Responding to the request can 
include providing a web page, access to a software process or anything else 
appropriate for the particular resource. If, in step 1 832, it is determined that there 
are header variables, then in step 1836 the resource searches for a particular 

10 variable name. In order to use header variables, the resource must be 
preprogrammed to know what header variables to expect and how to use them. 
Thus, the resource will have a list of variable names it seeks. In step 1836, the 
resource looks for one of the listed variable names in the set of header variables. 
Once found, the resource reads the string for the found variable in step 1838. In 

15 step 1840, the resource reads the variable value (e.g. LDAP attribute). When 
HTTP variables are set up in actions, a variable name, a string for the variable and 
data for the variable are provided. In step 1842, it is determined whether any 
variables to operate on. If so, the method of Figure 47 loops back to step 1 836. If 
there are no more variables to operate, then in step 1 844 the resource acts on the 

20 variables by taking the information from the variables and using them in the 
manner appropriate for the particular resource. In step 1 846, the resource responds 
to the request as appropriate for that particular resource. 

One example for using the process of Figure 47 is to provide an automated 
login for a downstream application. For example, upon authentication or 

25 authorization successes, login information for a particular user and a particular 
application can be added to the HTTP request as header variables. The 
downstream application can be programmed to search the header variables for the 
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login and password information and automatically attempt to authorize the user. In 
another example, user identity profile information is passed to a downstream 
application without the user accessing the application directly. This user identity 
profile information would be stored in header variables and provided to the 
resource being accessed. Thus, the resource being accessed can be fully 
customized for the user accessing the resource. For example, the resource can 
address the user by name and title and access preferences for that user. There are 
an unlimited number of resources that can be accessed by a user and, thus, 
unlimited ways to use the information contained in header variables. 

As discussed above, the Access System monitors and logs various events, 
including authorization and authentication failure/success events. In other 
embodiments, other events can be monitored and logged. When an event being 
monitored occurs, an entry is added to an appropriate audit log. For purposes of 
the present invention, the terms log and log entry are used broadly because no 
special format is necessary for the present invention. A log can include any 
reasonable and organized system for storing information. 

Figure 48 provides a flow chart detailing the steps performed for logging 
authentication and/or authorization events (see steps 764, 774, 792, and 796 of 
Figure 22). In one embodiment, the steps of Figure 48 are performed by Web Gate 
28 and auditing module 544. The log process is configurable because the audit rule 
associated with a requested resource can specify any combination of information to 
be logged in audit logs 546 in response to a detected type of event selected to be 
audited. For example, in one embodiment of the present invention, an audit rule 
associated with a requested resource can specify that all or a subset of the attributes 
of the identity profile for the user making the access request should be logged in 
one of audit logs 546 for the specific event. In another embodiment, the time of 
the authentication and an identification authorization event is logged in one or 
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more of audit logs 546. An identification of the resource, the rule evaluated, the 
type of event, the IP (or other) address of the requesting machine, user ID, an 
identification of the operation being performed (e.g. GET, etc.) an identification of 
the Web Gate and/or access server that processed the request, user password and 
any other suitable information can also be logged. 

Storing identity profile information, as well as the other information listed 
above, allows the system to provide data for load balancing, various business 
reports, and reports about how the system is being used. For example, knowledge 
of which resources are being accessed, when resources are being used and who is 
accessing the resources can allow an administrator to perform load balancing on 
the system. Reports identifying which content is being accessed the most can help 
a business allocate resources. Information about how various entities use the 
system can provide behavioral data to the host. Various other business reports and 
monitoring can also be useful. 

The process of Figure 48 is commenced by the detection of an access 
system event. In the embodiment of Figure 22, both the attempt to authenticate 
(steps 760 & 762) and the attempt to authorize (steps 756 & 790) can be thought of 
as the detection of an access system event. Thus, the access system events of the 
embodiment of Figure 22 includes authorization success, authorization failure, 
authentication success and authentication failure. Other access system events can 
also be monitored for use with the present invention. In other embodiment, 
detecting an access system event can utilize different means than explicitly 
described in Figure 22, as long as the system has a means for knowing that an 
event occurred. Alternatively, an access system event can be detected using 
specific monitors or sensors. 

In step 1 870 of Figure 48, Web Gate 28 reads audit mask 503 from resource 
cache 502 in response to an authentication or authorization result. If audit mask 
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503 indicates that the event is not audited (step 1872), then the method is done 
(step 1874). If the event is to be audited (step 1872), then Web Gate 28 passes 
retainer 505 to auditing module 544, thus identifying the applicable policy domain 
and/or policy for auditing. In step 1878, auditing module 544 reads the audit rule 
5 associated with the requested resource from audit rule cache 574. In one 
embodiment, the audit rule read in step 1878 will be a first level (default) audit 
rule, a second level (specific) audit rule, or a master audit rule applicable to all 
resources when neither a first or second level audit rule is found. In stepl880, 
auditing module 544 logs information specified by the found audit rule into one or 

10 more audit logs 546. In one embodiment of the present invention, Access Server 
34 informs auditing module 544 of authentication and authorization events to be 
logged, thus, allowing auditing module 544 to perform steps 1878 and 1880 
directly in response to an authentication or authorization result, rather than waiting 
to be prompted by Web Gate 28. 

1 5 Figure 49 provides a flow chart of a method for loading audit rules (see step 

846 of Figure 23). In step 1900, Access Server 34 loads the default audit rule for 
the policy domain mapped in step 836 of Figure 23 from Directory Server 36 into 
audit rule cache 574. Access Server 34 then selects a rule in array 565 (step 1902) 
and determines whether the selected rule is a specific audit rule for a policy 

20 associated with the requested resource, by using the method of Figure 26 
previously described above (step 1904). If the resource is part of the policy, then 
Access Server 34 proceeds to step 1912. Otherwise, Access Server 34 determines 
whether all rules in array 565 have been considered (step 1906). If not, then 
Access Server 34 selects the next rule in array 565 (step 1908), and returns to step 

25 1 904. Once all rules in array 565 have been considered (step 1 906), Access Server 
34 proceeds to step 1912. If a second level authentication rule was found for the 
requested resource in step 1904, then authentication module 540 caches the second 
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level audit rule in audit rule cache 574 (step 1912) and proceeds to step 1914. In 
step 1914, Access Server 34 prepares audit mask 503, identifying the 
authentication and authorization events to be logged (audited) by auditing module 
544 in accordance with the second level audit rule. If a second level audit rule was 
not found (step 1910), then the first level audit rule previously loaded in step 1 484 
remains in audit rule cache 574, and Access Server 34 prepares audit mask 503 
using the first level audit rule. Thus, when the method of Figure 49 is done, only 
one audit rule for the requested resource will remain in audit rule cache 574. 

Figure 50 depicts one embodiment of components used to detect attempted 
intrusions. The attempted intrusions can be inadvertent or malicious. The goal is 
to detect attempted intrusions of the access system, which includes the protected 
resources. Figure 50 shows audit logs 546 which can be one or more logs for 
logging various events. For example, there could be one log for logging 
authentication failure events, one log for logging authorization failure events, etc. 
Alternatively, there could be one log for logging multiple types of events. In one 
embodiment, for each log, or each type of event, an audit log sensor 548 monitors 
the type of event occurring. For example, in one embodiment there is an 
authentication failure sensor and an authorization failure sensor. If other events are 
monitored, there can be a sensor for each of the other events. When an 
authorization failure event occurs and a log entry is added to audit log 546 for the 
event, the authorization failure sensor will make a copy of the log entry and send it 
to database server 1934. Each of the audit log sensors 548 will send copies of log 
entries they detect to database server 1 934. In one embodiment, database server 
1934 includes an SQL database for storing all of the received log entries. 
Periodically, database server 1934 sends a set of log entries to security server 1936. 
In one embodiment, database server 1934 is stored within the local system of 
Figure 1 and security server 1936 is located offsite. In one embodiment, database 
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server 1934 is not provided and the various log sensors send their log entries 
directly to security server 1 936. As discussed above, the audit log entries are fully 
configurable. The log entries sent by the sensors can be exact duplicates of the log 
entries in the audit logs or they can be reformatted versions or versions that store 
only a subset of the original information. 

Figure 5 1 provides a flow chart describing the operation of the components 
depicted in Figure 50. In step 1950, an event is logged. The system is fully 
configurable to allow the sensors to monitor all or a subset of events being logged. 
The events being monitored by sensors 548 are denoted as registered events. For 
example, in one embodiment, the system logs all authentication failure, 
authentication success, authorization failure and authorization success events, 
while sensors 548 monitor only authentication failure and authorization failure 
events. In step 1952, it is determined whether the logged event is a registered 
event. If not, the method of Figure 51 is done (step 1964). If it is a registered 
event, then in step 1954 the sensor accesses instructions for the event type. For 
each event type being monitored by a sensor, the system is configurable to perform 
any action specified by the administrator. For example, in one embodiment, an 
action will be to send the log entry to a database server. In another embodiment 
the action will also include adding information to the log entry such as information 
from a user identity profile, login information, time, date, etc. In step 1 956, sensor 
548 accesses the log entry and performs instructions for the event type to the log 
entry in step 1958. As discussed above, one exemplar instruction requests that the 
sensor sends the log entry to either database server 1 934 or security server 1936. If 
the sensor is instructed to send the log entry to database server 1 934, then database 
server 1934 receives and stores the log entry in step 1960. In step 1962, database 
server 1934 will periodically send all or a subset of the log entries to security 
server 1936. 
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Figure 52 is a flow chart describing the operation of security server 1936. 
In step 1980, security server 1936 receives a log entry. Step 1980 could include 
receiving a particular log entry directly from a sensor 548 or receiving a set of log 
entries from database server 1934. In step 1982, the log entries are stored at 
security server 1936. In step 1984, a rules engine is run on a set of stored log 
entries. The log entries used in step 1984 could include the newest set of log 
entries and, optionally, previous log entries going back historically as needed by 
the rules engine. The rules engine can look for any particular pattern of events. In 
one embodiment, the steps of Figures 51 and 52 are used to detect one or more 
attempts of intrusion of the system. For intrusion detection, the rules engine looks 
for patterns over time of an entity attempting to wrongfully access resources in the 
system of Figure 1 . In such a case, various patterns can be detected. For example, 
the rules engine may look for three authorization failures for the same entity or 
three authentication failures with the same login name or password. Security 
server 1936 correlates events over time to identify persons or actions that constitute 
security breaches or attempted security breaches. 

Figure 53 provides a flow chart detailing the steps performed by Access 
Manager 40 for flushing and synchronizing caches of Web Gate 28 and Access 
Server 34 in accordance with the present invention. If a change is made (by an 
administrator, user, or otherwise) to a policy domain or a policy stored on 
Directory Server 36, any affected first level or second level rules cached in the 
respective caches of Web Gate 28 and Access Server 34 will become stale data. 
Similarly, if a change is made to user identity profiles 102 or revoked user list 108 
on Directory Server 36, previously cached versions of the changed data will 
become stale. Accordingly, the respective caches of Web Gate 28 and Access 
Server 34 must be flushed to prevent Web Gate 28, Access Server 34, User 
Manager 38, Access Manager 40, or System Console 42 from using the stale data. 
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In step 201 0, Access Manager 40 detects a change to data stored on 
Directory Server 26. In step 2012, Access Manager 40 reads the previous Global 
Sequence Number (GSN) 112 stored on directory server 36. In step 2014, Access 
Manager 40 assigns a current GSN to the change detected in step 2010. In one 
embodiment of the present invention, the current GSN is the next sequential 
number after the previous GSN 112. In step 2016, Access Manager 40 stores the 
current GSN on Directory Server 36, replacing the previous GSN 1 12. In step 
2018, Access Manager 40 generates a synchronization (sync) record to facilitate 
cache flushing. In step 2020, Access Manager 40 passes a cache flush request and 
the newly generated synchronization record to each Access Server 34. 

Figure 54 provides a block diagram of a synchronization record in 
accordance with the present invention. Synchronization record 2040 includes the 
current GSN 2042 assigned to the change detected in step 2010 of Figure 53. 
Synchronization record 2040 also includes IDs 2044, which identify the data 
affected by the detected change, such as the policy domain, first level rules, policy, 
second level rules, etc. Synchronization record 2040 also indicates what type of 
change 2046 was detected (e.g. whether it be an addition, modification, or 
deletion). Time 2048 is also stored, indicating the time at which the change was 
detected in step 2010. 

Figure 55 provides a flow chart detailing steps performed by Access Server 
34 in response to receiving a synchronization record 2040 from Access Manager 
40. In step 2060, Access Server 34 receives a synchronization record and flush 
request. Access Server 34 updates its stored GSN by replacing the stored GSN 
with the synchronization record GSN (step 2066). In step 2068, Access Server 34 
then flushes the cached information identified by elements 2044, 2046, and 2048 of 
synchronization record 2040. Access Server 34 then stores synchronization record 
2040 on Access Server 34 (step 2070). 
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Figure 56 provides a flow chart detailing the steps performed by Web Gate 
28 for flushing and synchronizing its caches in accordance with the present 
invention. In step 2100, Web Gate 28 issues a request to Access Server 34. Upon 
serving the request, Access Server 34 returns the value of its stored GSN 554 (step 
2102) to Web Gate 28. Web Gate 28 compares the GSN 544 returned in step 2102 
with GSN 510 stored by Web Gate 28 (step 2104). Web Gate 28 requests all 
synchronization records 550 stored on Access Server 34 having GSN's greater than 
GSN 510 stored on Web Gate 28 or appearing in sync record table 518. Web Gate 
28 flushes data having ED's 2044 (specified in synchronization record 2040 
received from Access Server 34) from its caches (step 2110). In step 2112, Web 
Gate 28 updates its GSN 510 to equal GSN 554 stored on Access Server 34 (step 
2112). In one embodiment, Web Gate 28 maintains a sync record table 518 that 
identifies all sync records that have not yet been processed by Web Gate 28. For 
example, a sync record will remain unprocessed if its transmission to Web Gate 28 
from Access Server 34 is delayed. In step 2114, Web Gate 28 updates table 5 1 8 by 
removing entries for synchronization records processed in step 2110. 

Figure 57 provides a flow chart describing the process of testing access to 
resources using the system of Figure 1 . Access Manager 40 includes an Access 
Tester process. The Access Tester allows an administrator, or any other authorized 
user, to determine who or what entities may access a resource under the current 
access criteria, whether a particular individual or set of individuals have access to a 
resource under certain conditions and whether the first level and second level rules, 
policies or policy domains associated with a resource operate as intended. In one 
embodiment, an administrator accesses the Access Tester using a GUI on Access 
Server 40. In one implementation, the system tests access to a resource without 
actually authenticating or authorizing access to the resource. Thus, the system is 
testing a successfully authenticated user's access to the resource. In step 2260, the 
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administrator enters a URL (or other identities) for a resource to be tested. In one 
alternative, multiple URLs can be entered so that the test is performed for multiple 
resources. In another alternative, the administrator can select to test for all possible 
resources so that the Access Tester will determine which resources are available to 
the users identified for the test. In step 2262, the administrator selects the HTTP 
request methods that the administrator wants to test. If no HTTP request methods 
are entered, the system will test all HTTP request methods. Protocols other than 
HTTP can also be used. In accordance with the present invention other protocols 
besides HTTP can be used. If the administrator wants to know if a particular 
computer can access the resource, the administrator can enter the computer's IP 
address in step 2264. If no IP address is entered in step 2264, then the test will not 
be limited to any particular computer. 

In step 2266 of Figure 57, the administrator can enter date and time 
restrictions, hi one embodiment, the administrator can indicate that any time and 
day can be used so that the timing and date restrictions do not restrict the test. 
Alternatively, the administrator can enter a specific time and/or date for testing. 
The date and time information can identify a specific date and time or ranges of 
dates and times. As discussed above, policies can be configured to allow certain 
access by users at certain times on certain dates. In step 2268, the administrator 
selects which users to test access for. The administrator can request testing for all 
possible users or subsets thereof. If the user desires to test for selected users, the 
administrator can identify individual users. Alternatively, the administrator can 
use filters, rules, or roles to identify subsets of users. Testing for all users allows 
an administrator to see which users have access to a particular resource. Steps 
2260-2268 are information gathering steps. In one embodiment, they are 
performed by having an administrator enter information into Access Manager 40. 
In other embodiments, this information is provided to the Access Tester via a file, a 
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software process, information exchange protocols such as XML, etc. 

Steps 2270-2282 are performed by the Access Tester in order to test access 
to the resource in question. In step 2270, the policy domain is identified for the 
URL entered in step 2260 using the processes described above. In step 2272, the 
system searches for a policy associated with the URL in accordance with the 
processes described above. If more than one URL was entered in step 2260, than 
more than one policy or more than one policy domain may be identified. In step 
2274, the Access Tester chooses one user from the set of users selected in step 
2268 and the identity profile for the chosen user is accessed (optional). In step 
2276, authorization is checked for that user. Step 2276 is performed in a similar 
manner as described above with respect to step 756 of Figure 22, except that after 
it is determined whether the user is authorized, no log entry is created and the user 
is not actually authorized. If a policy was found in step 2272, then the 
authorization rules for the policy are used in step 2276. If no policy was found in 
step 2272, then the default authorization rules for the policy domain are used in 
step 2276. The information from steps 2262, 2264, and 2266, and the user's 
identity profile (optional) are used to determine whether the one or more applicable 
authorization rules are satisfied. If they are satisfied, then it is determined that the 
particular user is authorized to access the resource under the conditions entered in 
steps 2260-2268. In step 2278, it is determined whether there are more users from 
the set of users identified in step 2268. If there are more users, another user is 
chosen in step 2280 and the identity profile for that user is accessed. After step 
2280, the method loops back to step 2276. If there are no more users to consider 
(step 2278), then the results are displayed in step 2282. 

In one embodiment, the method of displaying and/or the contents of the 
results in step 2282 are configurable. For example, the administrator can select 
whether the matching policy domain, policy and/or matching rules should be 
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displayed. One embodiment of step 2282 includes displaying a table (not shown) 
in a GUI listing all users. For each user, the table displays the URL in question, 
the request method tested, the policy domain, the policy, the authorization rules, 
date and time information, IP address information, and an indication of whether the 
user is authorized to access the resource. In one embodiment, only a configurable 
subset of this information is displayed. It is possible that a user may have multiple 
entries in the result table, for example, when the date and timing information 
results in access grants at some times and access denials at other times. The results 
table allows an administrator to determine whether the policies created for a 
particular resource or set of resources are appropriate. In addition, the 
administrator can use the Access Tester to determine whether specific users have 
appropriate access rights. The Access Tester quickly allows an administrator to 
verify authorization rules created for particular policy domains and/or policies. In 
alternative embodiments of step 2282, the results are reported in a file, in XML, on 
a printer, using voice, etc. In one embodiment, the results reported could include 
an indication that access is granted, access is denied, there is redirection to a 
different resource or it is undetermined (e.g. a custom authorization plug-in cannot 
be loaded). 

Various alternatives to the above-described embodiments are also within 
the spirit of the present invention. For example, in one embodiment, the system of 
Figure 1 can include a separate Identity Server which will perform many (or all) of 
the tasks associated with managing the Identity System. In one embodiment, such 
an Identity Server would include a Publisher, a User Manager, a Group Manager 
and an Organization Manager. 

The Publisher is an application that lets a user publish LDAP-based 
directory information about users, reporting structures, departments, offices and 
other resources stored in enterprise directories. The User Manager is responsible 
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for password management, certificate management, and delegation administration 
of user identity profiles. For example, the User Manager can create and delete 
users, roles, rights and credentials. 

The Group Manager manages groups. When a company is setting up an 
5 Extranet/Internet or ASP services, the company will need to provide only certain 
groups of people with access to the application/resources that they are making 
available. The entities in a group can be determined by specifically adding a 
person or group, or by identifying a specific attribute or value in user identity 
profiles. Companies can use these methods to use roles/rights management, or to 

10 grant/deny access to the applications that they will need. The Group Manager will 
manage this group functionality, including supporting multiple types of groups, 
managing group ownership, group membership, group administration, etc. 

The Organization Manager is used to manage organizations. When 
companies are dealing with outside partners, suppliers, or other organizations 

15 (internal or external), the companies need a way to manage those organizations 
including creating the entity, modifying it or deleting it. There are three 
fundamental data structures that are used to organize directory data in the directory 
server: (1) User objects for the actual information about the user; (2) group objects 
for collections of users; and (3) organization objects, which are containers for user, 

20 group and other organization objects. Organizations can be created and removed 
from the system. Additionally, organizations can be managed by a manager, self 
managed, or managed in a delegated fashion. 

The system can also be implemented with multiple Identity Servers. Each 
Identity Server will have its own cache or set of caches. In one scenario, if one of 

25 the Identity Servers change it cache, it will communicate to the others to flush their 
cache. 

Another alternative embodiment will include Public Key Infrastructure 
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(PKI) integration. By deploying PKI, customers can issue certificates to various 
users. PKI is a key technology for enabling e-business and e-commerce by making 
transactions and interactions that are more secure between companies and across 
the Internet. 

Another embodiment includes Pre and Post Processing (PPP). PPP server- 
side hooks allow customers to extend the business logic of the Identity Systems by 
communicating with other systems before and after an event happens in the 
Identity System (or Access System). Customers can hook shared libraries, Pearl 
scripts or any other applications that can be called from specific well defined points 
in the processing logic of the application. As an example, during the user creation 
work flow process, a customer might want to call out to another system that creates 
an account for a user and provides information that should be stored in the user 
identity profile. As part of the call out, information can be returned to the Identity 
System. PPP can be used to perform data validation and password management. 
PPP could also be used as a notification engine (e.g. when a given action occurs, 
send an email). 

In one embodiment, the system is implemented as a three-tier architecture. 
This allows the Identity System to be placed behind a firewall, while the only 
component exposed outside the firewall (or in the DMZ) is a Web Server with a 
Web Pass plug-in. The Web Pass plug-in is a plug-in for the Web Server that 
communicates with the Identity Server. The Web Pass Plug-in is analogous to the 
Web Gate for the access system. This allows customers to run the system with 
enhanced security and provides another point to do fail over, load balance and 
utilize redundant servers. 

In another embodiment, the system of Figure 1 can accept input in XML 
format and provide output in XML format. Additionally, the system will make use 
of XML remote procedure calls (RPC). 
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In an alternative implementation, the system could attempt to validate data 
on input. If a user or application enters data into the system that is outside 
predefined constraints, the data will be rejected. 

In one variation, Access System authorization rules and actions can be 
5 created by third party developers through an API. In one embodiment, these 
custom authorization rules and actions are programmed in C code. In another 
embodiment, custom authorization rules and actions can reside in an Access 
System with pre-existing authorization rules and actions. 

In another embodiment, "affiliate" Web Gates are installed on remote Web 

10 Servers to provide single sign-on authentication across multiple organizations. The 
affiliate Web Gates can access Web Gates of the Access System, but cannot 
directly communicate with Access Server 34. For example, a first company may 
maintain a web site protected by an Access System in accordance with the present 
invention. If the first company agrees to allow customers of a second company to 

15 access a subset of resources on the first company's web site, an affiliate Web Gate 
will be installed on the second company's web server. When a customer of the 
second company requests resources from this subset, the affiliate Web Gate will 
request a Web Gate of the Access System to authenticate the customer. The 
Access System Web Gate will return a successful or unsuccessful authentication 

20 result to the affiliate Web Gate. 

Figure 4, above, shows a hierarchical directory structure. Other data 
structures can also be used. One example of a suitable alternative is a flat data 
structure that does not include a hierarchy. Another suitable example includes a fat 
tree, which is a hierarchy that has few levels and each level is wide (a lot of nodes). 

25 One additional feature that can be used with various data structures is the 
implementation of a variable search base. In some embodiments, a user can access 
the entire hierarchy, subject to access rules and localized access filters. In other 
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embodiments, users will be limited to only accessing portions of the hierarchy. For 
example, the system can be set up so that users underneath a particular node in the 
hierarchy can only access other nodes below that particular node. This restriction 
on access is done before applying any access criteria and localized access filters, 
and can be thought of as restricting the search base. In effect, the top root of the 
hierarchy can then vary on a per user or group basis. 

Another alternative embodiment for the Identity System is allow the flow of 
managing user identity profiles to be configurable so that they can match the 
procedures of the company or entity: 

Policy domain information and policy information can be stored with a 
resource, with a resource's information in the directory server or in a location on 
the directory server (or elsewhere)for storing sets of policy domain information 
and policy information. Additionally, the above described system can work with 
one directory server or multiple directory servers. 

Figure 58 is a block diagram that depicts an alternative embodiment that 
allows applications to use an application program interface (API) to accesses 
authentication and authorization services of an Access Server. The term 
"application" pertains to a broad range of the software including stand-alone 
programs, servlets, applets, enterprise java beans (EJB), server pages, etc. The 
embodiment of Figure 58 allows applications to authenticate users using access 
system defined authentication schemes, import user session state from cookies and 
authorize user requests for resources. Figure 58 shows web browser 3002 and Web 
browser 3004 connecting to Web Server 3008 and application server 3040 via the 
Internet (or other network) 3006. Web Server is 3008 includes a Web Gate 3010. 
Web server is 3008 can be used to access resource 3012 or resource 3014, as 
discussed above. Web Gate 3010 can communicate with Access Server 3016 and 
Access Server 3016 utilizes Directory Server 3018, as discussed above. 
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Figure 58 also shows Application Server 3030 in communication with Web 
Server 3012. Application server 3030 can include any set of applications. For 
example, application server 3030 may include servlets 3032 and EJBs 3034. The 
applications on application server 3032 can communicate with the access system 
using the Access Server API 3036. Thus, Figure 58 shows servlets 3032 and EJBs 
3034 in communication with Access Server API 3036. Access Server API 3036 is 
in communication with Access Server 3016. In one implementation, a web 
browser sends a request to Web server 3008. Web server 3008 forwards that 
request to servlets 3032. Servlet 3032, in combination with EJB 3034, 
communicates with Access Server API 3362 to authenticate and authorize the user 
of the web browser. The applications on application server 3030 can access many 
of the authentication and authorization services from Access Server 3016 by using 
the Access Server API 3036. Additionally, other types of applications different 
from the servlet/EJB configuration depicted will work with the present invention. 
Application server 3030 can also include one or more resources 3031. 

In another alternative, a web browser can send a request directly to an 
application server, without first going through a Web server. For example, web 
browser 3002 can send a request directly to application server 3040 (via the 
Internet). Application server 3040 is not connected behind a web server, a Web 
Gate or any other web agent; therefore, it does not have a web agent front end. . 
A web agent is a component (usually software, but can be hardware or a 
combination of hardware and software) that plugs into (or otherwise integrates 
with) a web server (or equivalent) in order to participate in providing access 
services. A Web Gate is one example of a web agent. Application server 3042 
includes applications 3042. As discussed above, applications 3042 can be any 
suitable application that can run on application server 3040. Application server 
3040 also includes Access Server API 3036, which is in communication with 
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Access Server 3016. In one embodiment, application server 303 can also include 
one or more resources 3041 . 

In another embodiment, the Access Server API is available on a platform 
other than an application server. For example, a stand alone application that is not 
on an application server may use the Access Server API. 

Note that the applications that can use the API are not limited to 
applications on an application server. The applications can be any executable build 
using the Access Server API. 

Depending on the programming languages supported, the Access Server 
API will include a set of one or more libraries of classes, functions, procedures, 
etc. that can be called by an application program to access services from Access 
Server 3016. In one embodiment of the Access Server API provides an interface 
for Java, C and C++, the Access Server API includes five classes: an authentication 
scheme class (ObAuthenticationScheme), a resource request class 
(ObResourceRequest), a user session class (ObUserSession), a configuration class 
(ObConfig), and an access exception class(ObAccessException). Each of these by 
classes are defined below. Note that other embodiments include a different set of 
classes to achieve similar functionality and include more or less than five classes. 

The authentication scheme class is used to create ObAuthenticationScheme 
objects. ObAuthenticationScheme objects represent authentication schemes 
defined through the Access System and used in the authentication rules for policy 
domains and policies. An authentication scheme specifies how a user is to be 
challenged for a set of credentials, name-value string pairs (for example, username 
and password) that are used to authenticate a user. An authentication scheme has 
the following elements: 

• a display name, 

• a mask indicating the authentication challenge method to be used 
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Challenge 
Method 


Mask 
Bit 


Expected credentials 


none 


0x00 


none; plug-in should map to anonymous user 


basic 


0x00 


userid and password (e.g. HTTP basic) 


certificate 


0x02 


certificate from SSL/TLS client authentication (e.g. https) 


form 


0x04 


customer-defined credential fields in an HTML login form 


secure 


0x08 


credentials must be sent over secure connection (e.g. https) 



• a numeric level indicating the strength of the authentication, 

• a redirection URL indicating where HTTP authentication is to be 



performed (may be empty), 

• a set of challenge parameters each of the form parameter walue which 
supply additional scheme-dependent information 



Name 


Scheme 


Value 


realm 


basic 


the authentication domain (e.g. an LDAP directory) 


form 


form 


the URL of the login form to be displayed to the user 


creds 


form 


a space-separated list of login form fields to be used as 
credentials 


action 


form 


the URL to which the login form posts its data 



• a sequence of plugins that specify how the credentials are to be 



processed. Plugins are not visible to user applications. 
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Authentication schemes are tied by authentication policies to resources. Certain 
aspects of authentication (audit policy, actions) are only defined for resources. 
ObAuthenticationScheme constructors consequently require an 
ObResourceRequest object to specify the authentication scheme. Below is the 
API in Java, C and C++: 

Java 

public class ObAuthenticationScheme { 

public ObAuthenticationScheme(ObResourceRequest res) throws 
O b Access Exce p tio n ; 



publ 
publ 
publ 
publ 
publ 
publ 
publ 
publ 
publ 
publ 
publ 
publ 
publ 
publ 

} 

C++ 



c String getName(); 
c int getMask(); 

c boolean requiresSecureTransport(); 

c boolean isBasic(); 

c boolean isCertificate(); 

c boolean isForm(); 

c boolean isNone(); 

c int getLevel(); 

c String getRedirectUrl(); 

c String getChallengeParameter(String parameterName); 

c Hashtable getAIIChallengeParameters(); 

c int getNumberOfChallengeParameters(); 

c Object clone() throws CloneNotSupported Exception; 

c void finalize(); 



class ObAuthenticationScheme { 
public: 

ObAuthenticationSchemeQ; // empty 
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ObAuthenticationScheme(const ObResourceRequest &res); 
ObAuthenticationScheme(const ObResourceRequest *pRes); 
ObAuthenticationScheme(const ObAuthenticationScheme Sother); // copy 
constructor 

const char *getName() const; 
int getMask() const; 

ObBoolean_t requiresSecureTransport() const; 

ObBoolean_t isBasic() const; 

ObBoolean_t isCertificate() const; 

ObBooleanJ: isForm() const; 

ObBoolean_t isNone() const; 

int getLevel() const; 

const char *getRedirectUrl() const; 

const char *getChallengeParameter(const char *parameterName) const; 
const ObMap &getAIIChallengeParameters() const; 
int getNumberOfChallengeParameters() const; 

} 
C 

typedef const void * ObAuthnScheme_t; 

ObAuthnScheme_t ObAuthn_new(ObResourceRequest_t res); 
const char *ObAuthn_getName(ObAuthnScheme_t scheme); 
int ObAuthn_getMask(ObAuthnScheme_t scheme); 
ObBoolean_t ObAuthn_requiresSecureTransport(ObAuthnScheme_t 
scheme); 

ObBoolean_t ObAuthn_isBasic(ObAuthnScheme_t scheme); 
ObBoolean_t ObAuthn_isCertificate(ObAuthnScheme_t scheme); 
ObBoolean_t ObAuthn_isForm(ObAuthnScheme_t scheme); 
ObBoolean_t ObAuthn_isNone(ObAuthnScheme_t scheme); 
int ObAuthn_getLevel(ObAuthnScheme_t scheme); 
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const char *ObAuthn_getRedirectUrl(ObAuthnScheme_t scheme); 

const char *ObAuthn_getChallengeParameter(ObAuthnScheme_t scheme, 

const char *parameterName); 
ObMap_t ObAuthn_getAllChallengeParameters(ObAuthnScheme_t 
scheme); 

int ObAutnn_getNumberOfChallengeParameters(ObAuthnScheme_t 
scheme); 

void ObAuthn_free(ObAuthnScheme_t *pScheme); 

The resource request class is used to create an ObResourceRequest object. 
An ObResourceRequest objects represent requests to access resources, including 

• the resource type, using built-in types (for example, http or ejb) or custom 
types defined through the access system. The resource type can be 
anything from a URL to an abstract alphatbetical string. 

• the name of the resource in the access system name space, in the format 

[//host[:port]]/resourceName 

where the optional host and port indicate the web or application server 
servicing the resource request. 

• the operation to be performed against the resource, with allowed operations 
defined by resource type; for example, GET and POST for http resources 
and EXECUTE for EJB resources. The operations for custom resource 
types are defined through the access system when the resource type is 

- defined. Other and custom operations can also be supported 

• optionally, a set of parameters (name-value pairs) for the requested 
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operation; parameter names and values must be strings. For http resources, 
this may be extracted from the request query string or post data. For EJB 
resources, they may be bean method parameters. In general, they can be 
any arbitrary data that the application developer and policy setter have 
agreed upon. 

'The ObResourceRequest constructors get policy information about the 
resource request from the access system: 

• whether the resource request is protected, and 

• the authentication scheme defined in the authentication policy that applies 
to the resource request. 

ObResourceRequest objects are used by the ObAuthenticationScheme 
constructors to retrieve information about the resource's authentication scheme and 
by the isAuthorized() method of the ObUserSession class to determine if a user is 
authorized to access the resource. Below is the API in Java, C and C++" 

Java 

public class ObResourceRequest { 

public ObResourceRequest(String resType, String res, String operation) 

throws ObAccessException; 
public ObResourceRequest(String resType, String res, String operation, 

Hashtable parameters) throws ObAccessException; 
public String getResourceType(); 
public String getResource(); 
public String getOperation(); 
public Hashtable getParameters(); 

public boolean isProtected() throws ObAccessException; 
public Object clone(); 
public void finalize(); 
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} 

C++ 

class ObResourceRequest { 
public: 

ObResourceRequest(); // empty 

ObResourceRequest(const char *resType, const char *res); 
ObResourceRequest(const char *resType, const char *res, const char *op); 
ObResourceRequest(const char *resType, const char *res, const char *op, 

const ObMap &parameters); 
ObResourceRequest(const ObResourceRequest &other); // copy 
constructor 

const char *getResourceType() const; 
const char *getResource() const; 
const char *getOperation() const; 
const ObMap &getParameters() const; 
int getNumberOfParameters() const; 
ObBoolean_t isProtected() const; 

} 
C 

typedef const void *ObResourceRequest__t; 

ObResourceRequest_t ObResourceRequest_new(const char *resType, 

const char *res, 

const char *op, 

ObMap_t parameters); 
const char *ObResource_getResourceType(ObResourceRequest_t res); 
const char *ObResource_getResource(ObResourceRequest_t res); 
const char *ObResource_getOperation(ObResourceRequest_t res); 
const ObMap_t ObResource_getParameters(ObResourceRequest_t res); 
ObBoolean_t ObResource_isProtected(ObResourceRequest_t res); 
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void ObResourceJree(ObResourceRequest__t *res); 

The user session class is used to create ObUserSession objects. 
ObUserSession objects represent a user who has successfully authenticated. A user 
session object is initially created through a constructor that authenticates the user. 
One constructor takes an ObResourceRequest object and an ObMap of credentials. 
The resource request determines the authentication scheme that is to be applied to 
the credentials to authenticate the user. The resource request also determines other 
aspects of authentication policy: success or failure actions and audit rules. 

A session token string is a serialized representation of the user session, for 
example, from the cookie stored on the client (see Fig. 37). A user session object 
can be constructed from a valid session token, and a session token can be generated 
from a user session object. 

A session token stored in a cookie is encrypted. The ObUserSession object 
can get the key (shared secret) from the directory server to decrypt the session 
token. The application communicating with the API does not have access to the 
key (shared secret). Thus, if an application wants information from the session 
token, the application must make a request to the ObUserSession object by calling 
one of the methods listed below, which will return the desired information in an 
unencrypted form. The session token stored in a cookie could have been originally 
created by the API or via a Web Gate. 

Elements of a user session object are 

• the user identity; for example, the DN of the user's profile entry in a user 
directory, 

• the level of the authentication scheme used to authenticate the user, 
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• an optional location (DNS hostname or IP address) of the user's client, 

• a session start time recording when the user authenticated, used to 
determine a session expiration, 

• a last use time set a user request is authorized, used to determine an idle 
session expiration, 

• actions (name- value pairs) set during authentication and authorization 
according to policy rules. Each rule defines an arbitrary type for each 
action that indicates to the application how the action is to be interpreted. 
For http, action types include "cookie: and "headerVar". 

• the status of session (logged in, logged out, login failed, or expired), and 

• an error number and localized error message from the most recent 
authentication or authorization. Error messages are defined in the 
ObAccessClient.msg message catalog and can have zero to five parameters 
inserted into the message. 

The isAuthorized() method of the user session class determines if the user is 
authorized to request an operation against a resource in the access system name 
space. Results of the authorization can be obtained through ObUserSession 
methods: an error number if the authorization failed, and authorization success or 
failure policy actions. An authorization audit record may be generated as specified 
by the audit rule associated with the resource request. Below is code for the API in 
Java, C and C++. 

Java 

public class ObUserSession { 
public ObUserSessionQ; // empty 
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public ObUserSession(ObResourceRequest res, Hashtable credentials) 

throws ObAccessException; 
public ObUserSession(ObResourceRequest res, Hashtable credentials, 
String location) 

throws ObAccessException; 
public ObUserSession(String sessionToken) throws ObAccessException; 
public String getUserldentity(); 
public int getLevel(); 
public String getl_ocation(); 
public int getStartTime(); 
public int getLastUseTime(); 
public int getNumberOfActions(String actionType); 
public Hashtable getActions(String actionType); 
public String getAction(String actionType, String name); 
public StringQ getActionTypes(); 
public int getStatus(); 
public int getError(); 
public String getErrorMessage(); 

public boolean isAuthorized(ObResourceRequest res) throws 
ObAccessException ; 

public String getSessionToken(); 
public void logoff(); 
public Object clone(); 
public void finalize(); 

// returned by getStatus() 
public static int AWAITINGLOGIN; 
public static int LOGGEDIN; 
public static int LOGGEDOUT; 
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public static int LOGINFAILED; 
public static int EXPIRED; 

// returned by getErrorQ 





public static 


int 


OK; 




5 


public static 


int 


ERR_ 


_AUTHN_PLUGIN_DENIED; 




public static 


int 


ERR_ 


_DENY; 




public static 


int 


ERR_ 


_IDLE_TIMEOUT; 




public static 


int 


ERR_ 


_INSUFFICIENT_LEVEL; 




public static 


int 


ERR_ 


_INVALID_CERTIFICATE; 


10 


public static 


int 


ERR_ 


.NOJJSER; 




public static 


int 


ERR_ 


_NOT_LOGGED_IN; 




public static 


int 


ERR_ 


_SESSION_TIMEOUT; 




public static 


int 


ERR_ 


UNKNOWN; 




public static 


int 


ERR_ 


_USER_REVOKED; 


15 


public static 


int 


ERR_ 


_WRONG_PASSWORD; 



} 

C++ 

enum ObUserStatus_t { 
ObUser_AWAITINGLOGIN = 0, 
20 ObUser_LOGGEDIN, 

ObUser_LOGGEDOUT, 
ObUser_LOGINFAILED, 
ObUser_EXPIRED 

}; 

25 enum ObUserError_t { 
ObUser_OK = 0, 

ObUser_ERR_UNKNOWN = 100, 
ObUser_ERR_NO_USER, 

Attorney Docket No.: OBLX-01022US0 BBM 
/oblx/1022/1022.001 



-102- 

ObUser_ERRJJSER_REVOKED, 

ObUser_ERR_WRONG_PASSWORD, 

ObUser_ERR_INVALID_CERTIFICATE, 

ObUser_ERR_AUTHN_PLUGIN_DENIED, 

ObUser_ERR_INSUFFICIENT_LEVEL, 

ObUser_ERR_NOT_LOGGED_IN, 

ObUser„ERR_SESSION_TIMEOUT, 

ObUser_ERR_IDLE_TIMEOUT, 

ObUser_ERR_DENY 

}; 

class ObUserSession { 
public: 

ObUserSession(); // empty 

ObUserSession(const char *sessionToken); 

ObUserSession(const ObResourceRequest &res, const ObMap 
&credentials, 

const char *location = NULL); 

ObUserSession(const ObResourceRequest *pRes, const ObMap 
&credentials, 

const char location = NULL); 

ObUserSession(const ObUserSession &other); // copy constructor 

const char *getUserldentity() const; 

const char *getLocation()const; 

const char *getAction (const char *actionType, const char *name) const; 
const ObMap &getActions(const char *actionType) const; 
const char **getActionTypes() const; // NULL terminated array of string 
pointers 

int getNumberOfActions(const char *actionType) const; 
int getLevel() const; 
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int getStartTime() const; 
int getLastUseTime() const; 
ObUserStatus_t getStatus() const; 
ObUserError_t getError() const; 
const char *getErrorMessage() const; 

ObBoolean_t isAuthorized(const ObResourceRequest &res); 
ObBoolean_t isAuthorized(const ObResourceRequest *pRes); 
const char *getSessionToken() const; 
void logoff(); 

} 

C 

typedef const void *ObUserSession_t; 

ObUserSession_t ObllserSession_fromToken(const char *sessionToken); 
ObllserSession_t ObUserSession_authenticate(ObResourceRequest_t res, 

ObMap_t credentials 

const char location); 
const char *ObUser_getUserldentity(ObUserSession_t user); 
const char *ObUser_getLocation(ObUserSession_t user); 
const ObMap_t ObUser_getActions(ObUserSession__t user, const char 
*actionType); 

const char *ObUser_getAction(ObUserSession_t user, const char 
*resType, 

const char *name); 
const char *ObUser_getSessionToken(ObUserSession_t user); 
int ObUser__getl_evel(ObUserSession_t user); 

int ObUser_getStartTime(ObUserSession_t user); 

int ObUser_getLastUseTime(ObUserSession_t user); 

ObUserErroM; ObUser_getError(ObUserSession_t user); 
cont char *ObUser__getErrorMessage(ObUserSession_t user); 
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ObllserStatus_t ObUser_getStatus(ObllserSession_t user); 
ObBoolean_t ObUser_isAuthorized(ObUserSession_t user, 

ObResourceRequest_t res); 
void ObUser_logoff(ObUserSession_t user); 

void ObUserJree(ObUserSession_t *user); 

Each client of the Access Server API must be configured through the access 
system, which creates an entry for the client in the policy directory. Also, each 
client must be locally configured using a tool which generates the initial bootstrap 
ObAccessClient.lst file. The ObConfig class includes class (static) methods to 
initialize and shutdown the Access Server API and to get part or all of the 
configuration for the client.. The initializeO method does the following: 

• Determines the installation directory for the client, either from its configDir 
parameter or from an environment variable OBACCESS_INSTALL_DIR. 

• checks that the ObAccessClient.lst file exists in the installation directory 
and is readable by the client program. 

• Reads the bootstrap configuration from ObAccessClient.lst. 

• Opens the ObAccessClient.msg message catalog to be used for user errors 
and exceptions. 

• Connects to one or more Access Servers specified in the bootstrap 
configuration. 

• Gets the full client configuration from the Access Server (which in turn 
reads the client's policy directory entry). 

• Creates the local resource request and authentication scheme caches. 
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• Creates a thread to periodically update the client's configuration. 

There is a shutdown() method that can be called to release resources when an 
application no longer needs to use the Access Server API. Below is code for Java, 
C and C++. 

Java 

public class ObConfig { 

public static void initialize() throws ObAccessException;; 

public static void initialize(String configDir) throws ObAccessException; 

public static void shutdown(); 

public static int getNumberOfltems() throws ObAccessException; 
public static Hashtable getAllltems() throws ObAccessException;; 
public static String getltem(String name) throws ObAccessException;; 

} 

C++ 

class ObConfig { 
public: 

static void initialize(const char *configDir = NULL); 

static void shutdown(); 

static ObMap &getAllltems(); 

static int getNumberOfltems(); 

static const char *getltem(const char* name); 

} 
C 

void ObConfigJnitiaIize(const char *configDir); 

void ObConfig_shutdown(); 

ObMap_t ObConfig_getAllltems(); 

int ObConfig_getNumberOfltems(); 

const char *ObConfig__getltem(const char* name); 
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The configuration items are discussed in the table below: 



Name 


Value 


id 


string identifier for application; specifies the client's 
configuration in the policy directory 


cacheTimeout 


seconds that a cached authentication scheme or resource- 
request object will exist before it is automatically flushed. 
0 means cache elements will never be flushed. 


maxCacheElements 


maximum number of cached resource-request objects. 
The size of the authentication scheme cache is fixed. 


failoverThreshold 


if the number of connections to primary Access Servers 
falls below this threshold, the Access API will open 
connections to secondary Access Servers. 


Debug 


on or off. The interpretation is up to the application. 
WebGate with debug on traces all messages to Access 
Servers. 


encrvnted 


the security mode used for connecting to the Access 
Servers 

open - no encryption 

simple - TLS encryption, using certificates generated 
from a built-in CA 

cert - TLS encryption, using certificates issued by a full 
CA. 


lastUpdateTime 


the last time (in seconds since 1/1/1970 00:00) that 
client's configuration was updated. 


maxConnections 


the maximum number of connections that will be opened 
to Access Clients 


sessionTimeout 


seconds that a user session created by the application will 
be valid 


idleTimeout 


seconds between authorization class that invalidate a 
session 


accessServerTimeout 


seconds that a connection to an Access Server will be left 
open before it is re-established 


SleepFor 


how often (in seconds) that the client checks that its 
Access Server connections are up 


preferredHost 


For WebGate, the user's browser will be redirected to this 
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form of the web server host address if it did not originally 
specify it. Other applications are free to interpret or 
ignore this as needed. 


primaryDomain 


For WebGate, the domain to be used in setting cookies, 
e.g. the single signon domain. Other applications are free 
to interpret or ignore this as needed. 


state 


enabled or disabled. The interpretation is up to the 
application. A disabled WebGate immediately allows 
access to all resources. 


primaryServers 


the Access Servers to which the client will connect to 
first; a space-separated list of the format 
hostl:portl 9 numConnl Host2:port2,numConn2 ... 


secondary S ervers 


the Access Servers to which the client will connect to if 
the number of connections to the primary servers falls 
below the failoverThreshold; a space-separated list of the 
format hostl \portl ,numConnl host2:port2,numConn2 ... 



When the Access Server API methods detect problems, they will throw an 
ObAccessException object. Each exception can have from zero to five parameters 
that inserted in a message defined in the ObAccessClient.msg catalog. Below is 
the code for the API pertaining to the ObAccessException object: 

Java 

public class ObAccessException extends java.lang. Exception { 
public ObAccessException(String message); 

// inherited from Throwable 
public String toString(); 

} 

C++ 

enum ObAccessExceptionCode_t { 
ObAccessException_OK = 0, 
ObAccessException__UNKNOWN = 200, 
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ObAccessException__BAD_SESSION_TOKEN f 

ObAccessException_NO_SCHEME_ID, 

ObAccessExceptionJVIEED_PARAMETERS, 

ObAccessException_NOTJNITIALIZED, 

ObAccessException_CACHE_PROBLEM, 

ObAccessException JslO_CON F I G_F I LE , 

ObAccessException_NO_INSTALL_DIR_ENV, 

ObAccessException_NOT_PROTECTED, 

ObAccessException_MISSING_RESOURCE, 

ObAccessException_MISSING_OPERATION, 

ObAccessException_BAD_LOCATION, 

ObAccessException_NO_CLIENTJD, 

ObAccessException_JNI_ERROR, 

ObAccessException_OUT_OF_MEMORY, 

ObAccessException_M I SS I N GJTEM , 

ObAccessException_NO_MSG_CAT, 

ObAccessException_CLIENT_NOTJN_DIR, 

ObAccessException_OBERROR, 

// Exceptions for errors returned by the Access Server. 

ObAccessException_ASJJNKNOWN = 300, 

ObAccessException_ENGINE_DOWN, 

ObAccessException_NOCODE, 

ObAccessException_NULL_RESOURCE, 

ObAccessException^HOSTPORT^OOKUP^FAILED, 

ObAccessExceptionJJRLJJDOKUP^FAILED, 

ObAccessException_SD_LOOKUP_FAILED l 

ObAccessException_WROR_LOOKUP_FAILED, 

ObAccessException_WROR_AUTHENT_LOOKUP_FAILED, 

ObAccessException_NO_AUTHENT_SCHEME, 
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ObAccessException_EXCEPTION, 

ObAccessException_INVALID_SCHEMEJD, 

ObAccessExceptionJNVALID_SCHEME_MAPPING, 

ObAccessException_INVALID_SCHEME_PARAMETERS t 

Ob Access Exception_N 0_U S E R , 

ObAccessException_NONUNIQUE_USER ) 

ObAccessException_USER_REVOKED, 

ObAccessException_MISSING_OBCRED_PASSWORD, 

ObAccessException_WRONG_PASSWORD, 

ObAccessException_MISSING_PASSWORD, 

ObAccessException_MISSING_CERTIFICATE, 

ObAccessException_INVALID_CERTIFICATE, 

ObAccessException_INVALID_SELECTION_FILTER t 

ObAccessException_MISSING_AUTHN_PLUGIN, 

ObAccessException_AUTHN_PLUGIN_ABORT, 

ObAccessException_AUTHN_PLUGIN_DENIED, 

ObAccessException_AUTHN_PLUGIN_NO_USER 

}; 

class ObAccessException { 

ObAccessException(ObAccessExceptionCode_t code, 

const char *p1 = NULL, 

const char *p2 = NULL, 

const char *p3 = NULL, 

const char *p4 = NULL, 

const char *p5 = NULL); 
ObAccessExceptionCode_t getCode(); 
const char *toString(); 

static const char *getCodeString(ObAccessExceptionCode_t code, 
const char *p1 = NULL, 
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const char *p2 = NULL, 
const char*p3 = NULL, 
const char *p4 = NULL, 
const char *p5 = NULL); 

5 } 
C 

typedef void (*ObAccessExceptionHandler_t) (ObAccess Exception Cod e_t 
code); 

?g void ObAccessException_setHandler(ObAccessExceptionHandler_t 

f? 10 handler); 

«{g const char *ObAccessException_getCodeString(ObAccessExceptionCode_t 

^ code); 

I Since the C programming language does not provide an exception facility, the 

f23 Access Server API allows a C program to define an exception handler function that 

nj 15 is called when an exception is generated. 

r;j Figure 59 is a flow chart describing one embodiment of the operation of the 

components of Figure 58 when a user sends a request to access a resource using a 
web browser. The method of Figure 59 pertains to a request being sent to an 
application (e.g. servlet, EJB, etc) on application server 3040 or to a stand alone 

20 application running on any suitable platform having access to the Access Server 
API. In step 3 1 00, the request is received by application 3042. The request can be 
an HTTP request or a request using another protocol. If the request does not 
include the contents of a cookie (step 3102), then the user must be authenticated 
and authorized in step 3104. If the request includes information from a cookie 

25 (step 3102) then that information is accessed in step 3106. The information from 
the cookie (see above) is called a session token. In one embodiment, a session 
token is encrypted as described above. The session token is accessed from the 
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request in step 3 106. In step 3 1 08, a resource request object (ObResourceRequest) 
is created using information from the request. The resource request object is 
passed the resource type, the name of the resource, the operation being performed 
on the resource, and optional parameters which may include post data and/or query 
5 string data. 

In step 3110, an authentication scheme object (ObAuthenticationScheme) is 
created. The constructor for the authentication scheme object is passed the 
resource request object. In step 31 12, a user session object (ObUserSesssion) is 
created. The constructor for the user session object is passed the session token. 

10 The key for decrypting the session token is fetched from the directory server (if it 
is not already local), the session token is decrypted and the contents of the session 
token is stored in the new object. In step 3114, the system determines whether the 
cookie is valid. There are many ways for determining if the cookie is valid. In one 
example, the application can request information from the user session object such 

15 as the start time or last use time to determine whether the session is. still valid. If 
the cookie was not valid, then user must be authenticated and authorized in step 
3116. If the cookie is valid, then in step 3118 the application requests the 
authentication level from the authentication scheme object. For example, the 
application can call the get Level() method from theObAuthenticationScheme 

20 obj ect . This authentication level pertains to the authentication rule or policy stored 
in the directory server for the resource. In other embodiments, the different 
portions of the authentication scheme or all portions of the authentication scheme 
can be reported to the application by the API. In step 3120, the application 
requests the authentication level from the session object; for example, calling the 

25 getLevel() method from the ObUserSession object. This level information is a 
number originally stored (and encrypted) in the cookie. The ObUserSession 
provides the level in an unencrypted form. 
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In step 3 1 22, the application determines whether the authentication level in 
the cookie is less than or equal to the authentication level stored in the directory 
server for the resource. If so, then the user is properly authenticated for the 
resource, but still needs to be authorized to access the resource in step 3124. 
5 Because the user has already been properly authenticated, there is no need to 
request that the user provide any credentials (username, password, certificate, 
information for a form, etc). If the authentication level from the cookie is greater 
than the authentication level from the directory server, then user must be 
authenticated and authorized in step 3126. 

10 Figure 60 is a flow chart describing one embodiment of authenticating and 

authorizing a user with the components of Figure 58. Steps 3104, 3116 and 3126 
of Figure 59 perform the method of Figure 60. In step 3202, a resource request 
object is created, if it has not already been created. In step 3204, an authentication 
scheme object is created, if it has not already been created. In step 3206, it is 

15 determined whether the resource is protected. One example of performing step 
3206 includes calling the isProtected() method of the resource request object. The 
Access Server determines whether the resource is protected as described above. 

If the resource is not protected the application will allow the user to access 
the requested resource. If the resource is protected, the application accesses the 

20 authentication scheme in step 3208. One means for determining the resource 
authentication scheme is to use the various methods of the 
ObAuthenticationScheme class, described above. In step 3210, the application 
requests authentication credentials from the user and stores the credentials in a 
table in step 3212. The authentication credentials can be any data needed to 

25 authenticate. For example, a basic authentication credentials may include a 
username and a password. The exact type of credentials not important to the 
present invention. In one embodiment, the credentials is stored in a hash table. In 
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step 3 1 14, a user session object is created, if it has not already been created. The 
user session object is passed the resource request object and credentials stored in 
the table. The constructor of the user session object uses the resource request 
object and the credentials to authenticate the user in step 3216. The process of 
authentication is performed by the Access Server as described above. If the user is 
not properly authenticated (step 3222), then the application will send a response to 
a web browser in step 322 that the authentication failed and the user will not be 
given access to the resource. 

If the user was properly authenticated (step 3222), then the application will 
request a session token from the API in step 3226. In one embodiment, the session 
token can be requested using the method getSessionToken() of the ObUserSession 
class. In step 3228, a session token is added to a cookie stored on a client device. 
In step 3234, the application request the API to authorize the user. One 
embodiment step 3234 includes calling the isAuthorizedO to method. In step 3236, 
the access system will attempt to authorize user to access the requested resource. 
The process of authorization is performed by the Access Server as described above. 

If the user was properly authorized, then the application requests the API 
for the authorization actions and audit rules in step 3240. Note that step 3240 is 
optional. In one embodiment, the application will only request the authorization 
actions. In step 3242, the application will perform the authorization actions and 
(optionally) the audit rules. In one embodiment, the application can include log 
files for auditing. 

If the user was not properly authorized, then the application responds to the 
browser that authorization failed in step 3250. In step 3252, the application 
requested API for the authorization actions and/for rules. In step 3254, the 
application performs the actions/audit rules. As discussed above with respect to 
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authorization success, steps 3252 and 3254 are optional. One embodiment, the 
application only accesses the authorization actions and not the audit rules. 

Figure 61 is a flow chart describing the process of authorizing a user to 
access the resource without requesting additional authentication credentials and 
performing the full authentication process. The process of Figure 61 is performed 
during step 3124 Figure 59. In step 3302, it is determined whether the resource 
being requested is protected. As discussed above, one option for performing step 
3302 is to call the isProtected() method of the resource request object. If the 
resource is not protected, then the application allows the user to access the resource 
in step 3304. If the resource is protected, then the application requests the API to 
authorize the user in step 3306. The request to authorize uses the resource request 
object and the user session object. For example, step 3306 includes calling the 
isAuthorized() method of the user session object. In step 3308, the Access Server 
determines whether the user is authorized using the processes discussed above. If 
the user is authorized (step 3308), the application will allow access to the resource 
in step 3310. In step 3312, the application will request and receive the 
authorization actions and audit rules, and perform the necessary actions (and 
optional logging). If the user was not authorized to access the resource, then in 
step 3320 the application responds to the browser that authorization has failed. In 
step 3322 the application requests and receives the authorization actions and audit 
rules, and then performs necessary actions and/or logging (step 3322 is optional). 

Figure 62 is a flow chart describing, from a high level how a single sign-on 
(a user providing authentication credentials) can be used to access multiple 
resources. The various steps of Figure 62 use the particular methods described 
above. In step 3400, a user requests access to a first resource. This request is 
received by an application or a Web Gate. The user is authenticated in step 3402 
and a cookie is stored on the user's machine in step 3404. In step 3406, the user is 
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authorized to access the first resource. Subsequent to step 3406, the user requests 
access to a second resource. The request for access to the second resource is 
received by an application. In step 3410, the application, in conjunction with the 
API, authorizes the user to access the second resource without requesting the user 
to provide additional credentials for a full authentication. That is, the application 
receives the information from the cookie (the session token) and provides that 
session token to the API. If the information in the session token indicates that 
authentication is not necessary, then the user will not be requested to provide any 
additional credentials. 

The Access Server API should protect against several kinds of attacks. First, 
someone intercepting messages should not be able to obtain policy information or 
user attribute information. To protect against this, the messages must be encrypted 
with an algorithm and key strong enough to make cryptoanalysis of the messages 
infeasible. 

Second, someone with the Access Server API library and knowledge of the 
location of an Access Server must not be able to call the API to obtain policy or 
user information, unless specifically authorized to do so. The API client should 
authenticate itself to the Access Server, and the Access Server must apply 
appropriate authorization for the API client's requests. 

Third, someone must not be able to impersonate an Access Server to illicitly 
obtain information like authentication credentials from API clients. To protect 
against such a scenario, an Access Server should authenticate itself to its clients. 
Note that in this discussion of security, "API client" includes the WebGate web 
server agent as well as customer applications calling the Access Server API. 

The protocol for communicating with the Access Server provides three security 
modes, in increasing security and administrative overhead: open, simple, and cert. 
When an API client connects to an Access Server, both sides send an indication of 
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their configured security modes. If the configured client and server security modes 
do not match, the connection is terminated. 

Open mode provides no encryption. Consequently, policy and user information 
sent between the clients and servers cannot be protected against disclosure or 
5 alteration. Open mode is therefore not recommended in environments where the 
communication channels are not trusted. 

Simple mode is intended to provide strong encryption between clients and 
servers without requiring a full public key infrastructure (PKI). TLS (Transport 
Layer Security) is used between the client and server. Triple-DES symmetric 

10 encryption is used with a strong key randomly generated for each client-server 
connection and the RSA public key protocol is used to exchange the key between 
the client and server. To use RSA, each client and server has a public/private key 
pair and an X.509 certificate, generated by the access system when the component 
is installed. All simple mode certificates are signed by a private key built into the 

15 access system, so anyone with access to an installation can generate a valid 
certificate. Consequently the certificates cannot be trusted for authentication 
between the client and server. To compensate for this, simple mode adds an 
additional password challenge authentication protocol on top of TLS. The client 
and the server each share a secret password, supplied either in a local configuration 

20 file or interactively when the component is started. The server sends the client a 
challenge and the client generates a response by computing the MD5 digest of the 
challenge, a key derived from the password, and TLS connection data. The server 
authenticates the client by re-computing the digest from the same challenge, key, 
and TLS data and comparing it to the client's response. Similarly, the client 

25 challenges and authenticates the server. 

Cert mode provides strong encryption between clients and servers using 
TLS with triple-DES encryption and RSA key exchange, just as in simple mode. 
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But in cert mode, the client and server X.509 certificates are issued by a trusted 
certificate authority (CA) like VeriSign, so they can be used for mutual 
authentication between the client and the server. Consequently, the additional 
password challenge protocol in simple mode is not required. 

Access clients (WebGates and applications that use the Access Server API) 
have a password that is defined by a system administrator using the Access Client 
page of the Access System Configuration component. When an access client is 
configured, the client's password should be entered. The client password is 
encrypted and stored in a local configuration file, as well as the client's 
configuration entry in the policy directory. 

When an access client connects to an Access Server, the client sends the 
server its ID and they exchange randomly generated challenges. Each side then 
computes and sends to its peer the MD5 digest of the peer's challenge and the 
client's password, and the peer checks the received digest against its own 
computation of the digest. The connection is allowed only if the digest check is 
successful on both sides. Consequently, an access client can only connect to an 
Access Server if it is configured in the policy directory and both the client and the 
server know the same client password. Since digests of the password and challenge 
are exchanged instead of the password itself, this authentication method can be 
used safely over an unencrypted connection. 

Client authentication is done independently of the security mode, so the 
same challenge-password digests are exchanged over open, simple, and cert mode 
connections. This leads to multiple passwords in some modes. In simple mode, 
there is the global NAP password, the local certificate (PEM) file password and the 
password for each client. In cert mode there is the local certificate (PEM) file 
password and the password for each client. 

Below is pseudo code that further illustrates various features of the 
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embodiment of Figure 58. The first set of pseudo code authenticates a user, (using 
a basic userid and password) and checks if that user is authorized to access a 
specified URL: 

import java.util.*; 

import java.util. Enumeration; 

import com.oblix.access.*; 

public class AccessChecker { 

public static void main(Stringfl args) { 
if (args. length != 5) { 
System. out.println("expected: userid password HTTP-method URL"); 
return; 

} 

String userid = args[1]; 
String password = args[2]; 
String method = args[3]; 
String url = args[4]; 

try{ 

ObConfig.initialize(); // Expects OBACCESS_INSTALL_DIR env variable. 
ObResourceRequest res = new ObResourceRequest("http", url, method); 
if (res.isProtected()) 
{ 

// Check if the required authentication scheme is basic. 
ObAuthenticationScheme authnScheme = 

new ObAuthenticationScheme(res) 
if (authnScheme. isBasic()) { 
System.out.println( M BASIC REALM : B + 

authnScheme. getChallengeParameterCYealm")); 
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// Authenticate using the userid and password 

Hashtable credentials = new Hashtable(); 

credentials. put("userid'\ userid); 

credentials. put("password", password); 

ObUserSession user = new ObUserSession(res, credentials); 

if (user.getStatusO == ObUserSession. LOGGEDIN) { 

// Check if the user is authorized to access the URL. 
if (user.isAuthorized(res)) { 
System.out.printlnfGRANTED"); 

} 

else { 

System.out.printlnO'DENIED"); 

} 

// Display actions from authenticate() and isAuthorized(). 
System.out.printlnrACTIONS:"); 
String Q actionTypes = user.getActionTypes(); 
for (int i = 0; i < actionTypes. length; { 
Hashtable actions = user.getActions(actionType[i]); 
Enumeration e = actions. keys(); 
while (e.hasMoreElements())) { 
String name = (String) e.nextElement(); 
System.out.println(actionType[i] + ": " + name + "=" + 
actions.get(name)); 

} 

user.logoff(); 

} 

else { 

System. out.println("Login failed: " + user.getErrorMessage()); 

Attorney Docket No.: OBLX-01022US0 BBM 
/oblx/1022/1022.001 



-120- 

} 

} 

else { 

System. out.println("Resource authentication is not basic"); 

} 

} 

else { 

System. out.println("Resource is not protected"); 

} 

} 

catch (Throwable e) { // ObAccessException is a Throwable object 
System.out.println(e.toStringO); 

} 

} 

} 

The second set of pseudo code is a servlet fragment that gets a session 
token from a cookie (set by a WebGate or an application using the API) and 
determines if the user is authorized to access a requested URL. If the user's 
request is authorized, the requested resource is constructed. If the request is not 
authorized, a Not Authorized response is returned. 

import javax.servlet.*; 
import com.oblix. access.*; 

public class MyServlet extends HttpServlet 
{ 
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public void doGet(HttpServletRequest req, HttpServletResponse res) 
{ 

// Set the user session from the ObSSOCookie from WebGate. 
Cookiefl cookies = req.GetCookies(); 
String obSSOcookie; 
for (i = 0; i < cookies. length; i++) { 
if (cookies[i].getName().equals("ObSSSOCookie n )) { 
obSSOcookie = cookies[i].getValue(); 

} 

} 

ObUserSession user = new ObUserSession(obSSOcookie); 

// Make a parameter hashtable from the request query string: 

// namel =val1 &name2=val2... 

// Ignore hex decoding for this example. 

Hashtable parameters = new Hashtable(); 

String queryString = req.getQueryString(); 

if (queryString != null) { 

StringTokenizer t = new StringTokenizer(queryString, "=&"); 

while (t.hasMoreTokens()) { 
String name = t.nextToken(); 

String val = t.hasMoreTokens() ? t.nextToken() : null; 
parameters. put(name ( val); 

} 

} 

// Check if the user is authorized to access the requested resource. 
ObResourceRequest res = new ObResourceRequest( 
"http", 

req.getRequestURI(), 
req.getMethodQ, 
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req.makeQueryHashTable()); 
Hashtable actions = new Hashtable(); // initially empty 
if (!res.isProtected() || user.isAuthorized(res)) { 

// construct response 

} 

else { 

// construct Not Authorized response 

} 

} 

} 

The foregoing detailed description of the invention has been presented for 
purposes of illustration and description. It is not intended to be exhaustive or to 
limit the invention to the precise form disclosed. Many modifications and 
variations are possible in light of the above teaching. The described embodiments 
were chosen in order to best explain the principles of the invention and its practical 
application to thereby enable others skilled in the art to best utilize the invention in 
various embodiments and with various modifications as are suited to the particular 
use contemplated. It is intended that the scope of the invention be defined by the 
claims appended hereto. 
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